build a composite guide across repos
Change-Id: I094ec3ed64eba5bf03d517740ce41d720d604718
diff --git a/docs/README.md b/docs/README.md
index 6217e7f..b0797f5 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,10 +1,19 @@
-# Documentation
+# Testing CORD
-This directory contains docs related to
-* How to setup the test environment
-* How to execute tests on a given CORD POD
-* How to add additional use-cases
-* How to integrate the test environment into existing CD (Continuous Delivery)
- pipelines.
+The _CORD Automated Tester Suite (CATS)_ is an extensible
+end-to-end system test suite targeting CORD PODs. It is typically
+deployed as one or more Docker containers, either on the CORD POD
+or adjacent to the POD and interacts with the POD through the
+PODs interfaces.
+
+Its intended use includes:
+
+* Regression testing for CORD related component development
+* Acceptance testing of a deployed CORD POD
+* Health-testing of an existing CORD POD (including non-service-impacting
+ and possibly service-impacting tests)
+
+The strength of the CATS will come from the collaboration of the whole CORD/ONOS
+community, and as such we welcome contributions.