diff --git a/README.md b/README.md
index 904eee3..ec1125f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,20 @@
 # cord-tester
 CORD Automated Tester Suite
+
+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.
+
+For further information, please browse in the ~/docs directory.
+
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..6217e7f
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,10 @@
+# Documentation
+
+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.
+
+
diff --git a/docs/testcase_plans.md b/docs/testcase_plans.md
new file mode 100644
index 0000000..0c118cc
--- /dev/null
+++ b/docs/testcase_plans.md
@@ -0,0 +1,9 @@
+# Test-case Plans
+
+This is a rough list of planned test-cases, organized in areas. Feel free to
+contribute to the list and also use the list to get idea(s) where test
+implementation is needed. We plan to mark test-cases that are implemented
+as such as in this document, so we can also get a sense of progress. (However,
+there is not guarantee that the status is up-to-date.)
+
+
diff --git a/libs/README.md b/libs/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/libs/README.md
diff --git a/src/README.md b/src/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/src/README.md