From 9964e561560b795e7fe0c45cb1d43fe3fc1e0a8a Mon Sep 17 00:00:00 2001
From: Nicholas Ray <nray@wikimedia.org>
Date: Tue, 10 Mar 2020 21:30:30 -0600
Subject: [PATCH] Mustache Documentation: Cleanup/Clarify Mustache template
 params

* Content.mustache doc param order was modified to follow the html structure
order (with html-dataAfterContent at bottom ). `html-userlangattributes`
was added to param documention since it was absent.

* Footer.mustache doc param order was modified to follow the html structure
order (with `html-userlangattributes` placed after `html-vector-before-footer`)

* Navigation.mustache was modified to remove `html-sidebar`,
`html-navigation-left-tabs` and `html-navigation-right-tabs` params from
doc since those are absent from Navigation.mustache.

* `data-namespace-tabs`, `data-variants`, `data-page-actions`,
`data-page-actions-more`, `data-search-box`, `data-sidebar` params were
added in Navigation.mustache documentation since those are present.

Bug: T243281
Change-Id: I321f8d61ad0305f508521e8d4d805e846103b357
---
 includes/templates/Footer.mustache     |  2 +-
 includes/templates/Navigation.mustache | 11 +++++++----
 2 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/includes/templates/Footer.mustache b/includes/templates/Footer.mustache
index 91ed3b6..28505d1 100644
--- a/includes/templates/Footer.mustache
+++ b/includes/templates/Footer.mustache
@@ -9,8 +9,8 @@
   @prop string id of list element
   @prop footerItem[] array-items
 
-  string|null html-userlangattributes a string of attribute HTML
   string html-hook-vector-before-footer output of VectorBeforeFooter hook
+  string|null html-userlangattributes a string of attribute HTML
   footerRow[] array-footer-rows iterable list of footer rows
 }}
 {{{html-hook-vector-before-footer}}}
diff --git a/includes/templates/Navigation.mustache b/includes/templates/Navigation.mustache
index 03fd5c0..9cdbe88 100644
--- a/includes/templates/Navigation.mustache
+++ b/includes/templates/Navigation.mustache
@@ -1,10 +1,13 @@
 {{!
   string html-navigation-heading heading for entire navigation that is
     usually hidden to screen readers
-  string html-personal-menu content that appears as the first child of mw-head
-  string html-navigation-left-tabs that appears inside #left-navigation (namespaces and variants)
-  string html-navigation-right-tabs that appears inside #right-navigation (page actions and search)
-  string html-sidebar sidebar HTML
+  object data-personal-menu See PersonalMenu.mustache for documentation.
+  object data-namespace-tabs. See VectorTabs.mustache for documentation.
+  object data-variants. See VectorMenu.mustache for documentation.
+  object data-page-actions. See VectorTabs.mustache for documentation.
+  object data-page-actions-more. See VectorMenu.mustache for documentation.
+  object data-search-box. See SearchBox.mustache for documentation.
+  object data-sidebar. See Sidebar.mustache for documentation.
 }}
 <div id="mw-navigation">
     <h2>{{{html-navigation-heading}}}</h2>