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