From: jcgregorio <jcgregorio@google.com>
Date: Thu, 5 Mar 2015 15:11:13 +0000 (-0800)
Subject: Add some METADATA files to control docs layout.
X-Git-Tag: accepted/tizen/5.0/unified/20181102.025319~3317
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=71b03e468d941984f600d6bca4e26e00e2af7756;p=platform%2Fupstream%2FlibSkiaSharp.git

Add some METADATA files to control docs layout.

BUG=skia:3484
NOTRY=true
DOCS_PREVIEW= https://skia.org/?cl=976303002

Review URL: https://codereview.chromium.org/976303002
---

diff --git a/site/METADATA b/site/METADATA
new file mode 100644
index 0000000..5c6310b
--- /dev/null
+++ b/site/METADATA
@@ -0,0 +1,4 @@
+{
+  "dirOrder": ["user", "dev"],
+  "fileOrder": []
+}
diff --git a/site/dev/tools/markdown.md b/site/dev/tools/markdown.md
index ffdff4b..e624a27 100644
--- a/site/dev/tools/markdown.md
+++ b/site/dev/tools/markdown.md
@@ -34,6 +34,26 @@ the --port flag:
 
     docserver --preview --port=:8002
 
+METADATA
+--------
+
+By default all files and directories that appear in the same level are sorted
+alphabetically by file name in the navigation menu, with files appearing
+before 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
 ---------------------
diff --git a/site/user/METADATA b/site/user/METADATA
new file mode 100644
index 0000000..5d835d9
--- /dev/null
+++ b/site/user/METADATA
@@ -0,0 +1,4 @@
+{
+  "dirOrder": ["sample", "quick", "special"],
+  "fileOrder": ["download", "api"]
+}