diff --git a/requirements.txt b/requirements.txt
index d3643a6..5df9c30 100755
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,6 @@
 colorama>=0.2.5
 decorator>=3.4.0
 docker-py
-flake8>=2.5.1
 fluent-logger>=0.4.3
 klein>=15.3.1
 nose>=1.3.7
diff --git a/voltha/README.md b/voltha/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/README.md
diff --git a/voltha/adapters/README.md b/voltha/adapters/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/adapters/README.md
diff --git a/voltha/adapters/broadcom/README.md b/voltha/adapters/broadcom/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/adapters/broadcom/README.md
diff --git a/voltha/adapters/emulator/README.md b/voltha/adapters/emulator/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/adapters/emulator/README.md
diff --git a/voltha/adapters/grpc-shim/README.md b/voltha/adapters/grpc-shim/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/adapters/grpc-shim/README.md
diff --git a/voltha/adapters/microsemi/README.md b/voltha/adapters/microsemi/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/adapters/microsemi/README.md
diff --git a/voltha/adapters/mock/README.md b/voltha/adapters/mock/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/adapters/mock/README.md
diff --git a/voltha/adapters/tibit/README.md b/voltha/adapters/tibit/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/adapters/tibit/README.md
diff --git a/voltha/core/README.md b/voltha/core/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/core/README.md
diff --git a/voltha/northbound/README.md b/voltha/northbound/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/northbound/README.md
diff --git a/voltha/northbound/kafka/README.md b/voltha/northbound/kafka/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/northbound/kafka/README.md
diff --git a/voltha/northbound/netconf/README.md b/voltha/northbound/netconf/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/northbound/netconf/README.md
diff --git a/voltha/northbound/openflow/README.md b/voltha/northbound/openflow/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/northbound/openflow/README.md
diff --git a/voltha/northbound/rest/README.md b/voltha/northbound/rest/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/northbound/rest/README.md
diff --git a/voltha/northbound/wamp/README.md b/voltha/northbound/wamp/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/voltha/northbound/wamp/README.md