diff --git a/README.md b/README.md
index 4273908d..4b35be5b 100644
--- a/README.md
+++ b/README.md
@@ -14,37 +14,37 @@ Directories that contain only content
   <tr>
     <td>_android</td>
     <td>SDK tutorial. Part of the <a href="https://github.com/blockstack/docs.blockstack/blob/master/_data/navigation_learn.yml">developer menu</a>.</td>
-   <td></td>
+   <td><a href="https://github.com/blockstack/blockstack-android">https://github.com/blockstack/blockstack-android</a></td>
   </tr>
   <tr>
     <td>_browser</td>
-    <td></td>
-    <td></td>
+    <td>Information for end-users about our identity, Storage, and using the browser. There are also three of the original tutorials in there. User docs controlled by in the the <a href="https://github.com/blockstack/docs.blockstack/blob/master/_data/navigation_usenew.yml">user menu</a>. The three tutorials that appear in the <a href="https://github.com/blockstack/docs.blockstack/blob/master/_data/navigation_learn.yml">developer menu</a> There is an <a href="https://github.com/blockstack/docs.blockstack/issues/501" target="_blank">outstanding issue</a> to move these.</td>
+   <td><a href="https://github.com/blockstack/blockstack-browser">https://github.com/blockstack/blockstack-browser</a></td>
   </tr>
   <tr>
-    <td>_commong</td>
-    <td></td>
-    <td></td>
+    <td>_common</td>
+    <td>Contains several shell fills that redirect to our reference documentation sites such as Javascript, IOS, and so forth.  The reference docs are linked from the developer, core, and Gaia menus.</td>
+    <td>Each of these references are generated by their respective repos, core.blockstack.org from <code>blockstack-core</code>, Javascript docs from the <code>blockstack.js</code> and so forth.</td>
   </tr>
   <tr>
     <td>_core</td>
-    <td></td>
-    <td></td>
+    <td>Information for wallet, blockchain, or Clarity developers -- including Atlas, BNS, and so forth. <b>This content STILL needs to be synced with the master docs subdirectory in <a href="https://github.com/blockstack/blockstack-core/tree/master/docs" target="_blank">blockstack-core</a>.</b></td>
+    <td> <a href="https://github.com/blockstack/blockstack-core/tree/master/docs" target="_blank">blockstack-core</a></td>
   </tr>
   <tr>
     <td>_develop</td>
-    <td></td>
-    <td></td>
+    <td>Information for application miners covers using the Javascript library, our mobile SDKs, and the concepts hat support them. Navigation controlled by <a href="https://github.com/blockstack/docs.blockstack/blob/master/_data/navigation_learn.yml">developer menu</a> </td>
+    <td>This information was never associated with a single repo. Much of it does rely heavily on<a href="https://github.com/blockstack/blockstack.js">https://github.com/blockstack/blockstack.js</a>.</td>
   </tr>
   <tr>
   <td>_includes</td>
-    <td></td>
+    <td>Information reused (markdown or html) in many places, common html used in pages and notes.</td>
     <td></td>
   </tr>
     <tr>
     <td>_ios</td>
     <td></td>
-    <td></td>
+    <td><a href="https://github.com/blockstack/blockstack-ios">https://github.com/blockstack/blockstack-ios</a></td>
   </tr>
   <tr>
     <td>_org</td>
@@ -53,7 +53,7 @@ Directories that contain only content
   <tr>
     <td>_storage</td>
     <td></td>
-    <td></td>
+       <td><a href="https://github.com/blockstack/blockstack-gaia">https://github.com/blockstack/blockstack-gaia</a></td>
   </tr>
   </table>
 
@@ -64,22 +64,7 @@ Directories that contain only content
      <th>Notes</th>
   </tr>
   <tr>
-    <td>_android</td>
-    <td></td>
-   <td></td>
-  </tr>
-  <tr>
-    <td>_browser</td>
-    <td></td>
-    <td></td>
-  </tr>
-  <tr>
-    <td>_commong</td>
-    <td></td>
-    <td></td>
-  </tr>
-  <tr>
-    <td>_core</td>
+    <td>_common</td>
     <td></td>
     <td></td>
   </tr>
@@ -88,11 +73,6 @@ Directories that contain only content
     <td></td>
     <td></td>
   </tr>
-  <tr>
-    <td>_develop</td>
-    <td></td>
-    <td></td>
-  </tr>
   <tr>
     <td>_faqs</td>
     <td></td>
@@ -103,21 +83,11 @@ Directories that contain only content
     <td></td>
     <td></td>
   </tr>
-    <tr>
-    <td>_ios</td>
-    <td></td>
-    <td></td>
-  </tr>
 <tr>
     <td>_layouts</td>
     <td></td>
     <td></td>
 </tr>
-  <tr>
-    <td>_org</td>
-    <td></td>
-    <td></td>
-  </tr>
    <tr>
     <td>_plugins</td>
     <td></td>
@@ -133,11 +103,6 @@ Directories that contain only content
     <td></td>
     <td></td>
   </tr>
-  <tr>
-    <td>_storage</td>
-    <td></td>
-    <td></td>
-  </tr>
  <tr>
     <td>assets</td>
     <td></td>
@@ -147,11 +112,6 @@ Directories that contain only content
     <td>exclude</td>
     <td></td>
     <td></td>
-  </tr>
-    <tr>
-    <td>news</td>
-    <td></td>
-    <td></td>
   </tr>
   </table>