diff --git a/packages/okidoc-md/README.md b/packages/okidoc-md/README.md
index b5c8fd3..4d17e6b 100644
--- a/packages/okidoc-md/README.md
+++ b/packages/okidoc-md/README.md
@@ -1,3 +1,3 @@
 # okidoc-md
 
-> tool to build markdown files from javascript code with JSDoc. See https://wix.github.io/okidoc for details
+> Tool to build markdown files from javascript code with JSDoc. See https://wix.github.io/okidoc for details
diff --git a/packages/okidoc-site/README.md b/packages/okidoc-site/README.md
index 0fba2ce..25be367 100644
--- a/packages/okidoc-site/README.md
+++ b/packages/okidoc-site/README.md
@@ -1,3 +1,3 @@
 # okidoc-site
 
-> tool to build site from markdown files. See https://wix.github.io/okidoc for details
+> Tool to build site from markdown files. See https://wix.github.io/okidoc for details
diff --git a/packages/okidoc/README.md b/packages/okidoc/README.md
new file mode 100644
index 0000000..8cf78d3
--- /dev/null
+++ b/packages/okidoc/README.md
@@ -0,0 +1,3 @@
+# okidoc-md
+
+> Tool to document your code easy and flexible. See https://wix.github.io/okidoc for details