Document code structure in root readme

README.md

@@ -41,9 +41,31 @@ with any additional questions or comments.
 
 Get up and running quickly using our documentation at <https://aka.ms/fluid>.
 
-## Directory Structure
-
-_Coming soon._
+## Code Structure
+
+The core code is built into several large chunks ("minirepos", managed using Lerna) which are versioned separately from one another, but internally all packages in a minirepo are versioned together. And outside the minirepos there are plenty of packages which are versioned independently.
+
+Here's the breakdown of the repo:
+
+* Fluid Framework Client Minirepo ([lerna.json](./lerna.json))
+  * [Packages](./packages)
+  * [Example Components](./components/examples)
+  * [Experimental Components](./components/experimental)
+  * [Example host](./examples/hosts/iframe-host)
+* Reference Service ("Routerlicious") Minirepo ([dir](./server/routerlicious) | [lerna.json](server/routerlicious/lerna.json))
+  * [Packages](./server/routerlicious/packages)
+* Common Packages
+  * [Common Definitions](./common/lib/common-definitions)
+  * [Common Utils](./common/lib/common-utils)
+* Internal/Misc Packages
+  * [Build Common](./common/build/build-common)
+  * [ESlint Config](./common/build/eslint-config-fluid)
+  * Other Example Hosts
+    * [Electron Host](./examples/hosts/electron-host)
+    * [Literate](./examples/hosts/literate)
+  * [Docs](./docs)
+  * [Tools](./tools)
+  * [Other Server Packages](./server) (excluding [Routerlicious](./server/routerlicious) itself)
 
 ## Building
 

common/build/eslint-config-fluid/README.md

@@ -0,0 +1,3 @@
+# ESlint Config
+
+_Coming soon..._

common/lib/common-definitions/README.md

@@ -1,3 +1,3 @@
 # Fluid Common Definitions
 
-Common interfaces and definitions used in Fluid Framework
+Common interfaces and definitions used in Fluid Framework

common/lib/common-utils/README.md

@@ -1,2 +1,3 @@
-This package contains code for common utilities used by Fluid Framework
+# Fluid Common Utils
 
+Common utilities used by Fluid Framework

components/examples/README.md

@@ -0,0 +1,3 @@
+# Example Components
+
+_Coming soon..._

components/experimental/README.md

@@ -0,0 +1,3 @@
+# Experimental Components
+
+_Coming soon..._

examples/hosts/electron-host/README.md

@@ -0,0 +1,3 @@
+# Fluid Example Electron Host
+
+_Coming soon..._

examples/hosts/iframe-host/README.md

@@ -0,0 +1,3 @@
+# Fluid Example IFrame Host
+
+_Coming soon..._

examples/hosts/literate/README.md

@@ -1,5 +1,5 @@
 ---
-uid: loaders
+uid:  loaders
 ---
 
 # Literate Fluid Loader
@@ -16,7 +16,7 @@ of code.
 ## Build steps
 
 The first (and hardest) step to get up and running is to authenticate against the Fluid private npm feed. To do so
-navigate to https://offnet.visualstudio.com/officenet/_packaging?feed=prague&_a=feed, click the "Connect to feed" link,
+navigate to <https://offnet.visualstudio.com/officenet/_packaging?feed=prague&_a=feed>, click the "Connect to feed" link,
 choose "npm" and then follow the instructions.
 
 Once you've done that getting up and running is simple.
@@ -26,11 +26,11 @@ npm install
 npm start
 ```
 
-Then navigate to http://localhost:8080. This will redirect you to http://localhost:8080/example but you can change
+Then navigate to <http://localhost:8080.> This will redirect you to <http://localhost:8080/example> but you can change
 'example' to any string you'd like and a new document will be created under that name. By default a new Flow View
 will be created but by specifying the chaincode query parameter any of the packages on
-https://packages.wu2.prague.office-int.com can be loaded - i.e.
-http://localhost:8080/new-document?chaincode=@chaincode/tourofheroes@0.0.5918.
+<https://packages.wu2.prague.office-int.com> can be loaded - i.e.
+<http://localhost:8080/new-document?chaincode=@chaincode/tourofheroes@0.0.5918.>
 
 ## The Code
 

packages/README.md

@@ -0,0 +1,23 @@
+# Fluid Framework Client Core Packages
+
+_Details coming soon..._
+
+[agents](./agents) ...
+
+[drivers](./drivers) ...
+
+[framework](./framework) ...
+
+[hosts](./hosts) ...
+
+[loader](./loader) ...
+
+[runtime](./runtime) ...
+
+[server](./server) ...
+
+[test](./test) ...
+
+[tools](./tools) ...
+
+[utils](./utils) ...

server/README.md

@@ -8,6 +8,8 @@ This directory contains our reference server implementation. [Routerlicious](./r
 
 [Charts](./charts) Kubernetes charts for the micro-services
 
+[Gateway](./gateway) Internal landing page for Fluid, hosts Waterpark
+
 [Gitrest](./gitrest) provides a REST API to a GitHub repository. It's API is based off of GitHub's REST APIs.
 
 [Gitssh](./gitssh) is a git ssh server client container.
@@ -20,7 +22,7 @@ This directory contains our reference server implementation. [Routerlicious](./r
 
 [Routerlicious](./routerlicious) composed reference server implementation
 
-[Service](./service) Experimental routerlicious with faster throughput
+[Tinylicious](./tinylicious) Light-weight monolithic server implementation
 
 ## Build Status
 

tools/README.md

@@ -0,0 +1,23 @@
+# Fluid Framework Tools Dir
+
+_Details coming soon..._
+
+[build-server-resources](./build-server-resources) ...
+
+[fluid-build-tools](./fluid-build-tools) ...
+
+[fluid-metrics](./fluid-metrics) ...
+
+[fluidpreview-intercept](./fluidpreview-intercept) ...
+
+[generator-fluid](./generator-fluid) Yo generator for creating a new Fluid Component
+
+[getkeys](./getkeys) ...
+
+[headless-chrome](./headless-chrome) ...
+
+[logger](./logger) ...
+
+[repo-policy-check](./repo-policy-check) ...
+
+[search-content-extractor](./search-content-extractor) ...