Add some METADATA files to control docs layout.

site/dev/tools/markdown.md

Index: site/dev/tools/markdown.md
diff --git a/site/dev/tools/markdown.md b/site/dev/tools/markdown.md
index ffdff4b576ecc0a0eca6b2793a10d334af647c63..8df547fc9e38d4ea10df01e9390a0739a4ae89af 100644
--- a/site/dev/tools/markdown.md
+++ b/site/dev/tools/markdown.md
@@ -34,6 +34,25 @@ the --port flag:
 
     docserver --preview --port=:8002
 
+METADATA
+--------
+
+By default all files and directories that appear in the same level are sorted
+alphabetically in the navigation menu, with files appearing before

[hcm, 2015/03/05 14:38:30]

"sorted alphabetically by filename..." which I think you call out later, but
maybe add that nuance here.  This confused me at first when seeing the titled
pages not appearing to be alphabetically sorted.

[jcgregorio, 2015/03/05 15:10:02]

Done.

+directories. You can override this default behavior by adding a METADATA file
+to a directory. A METADATA file is a JSON file of the following format:
+
+~~~~
+   {
+     "dirOrder": ["sample", "quick", "special"],
+     "fileOrder": ["download", "api"]
+   }
+~~~~
+
+If a file or directory doesn't appear in `dirOrder` or `fileOrder` then it is sorted
+to appear after the members of `dirOrder` or `fileOrder` respectively. All
+files and directories that aren't controlled by a METADATA file are sorted in
+alphabetical order by their filename.
 
 Some Example MarkDown
 ---------------------