add detail about page metadata order

diff --git a/server/sonar-docs/README.md b/server/sonar-docs/README.md
index 38ba0ba17e0fea5baac66d9c8af092c47cce1f78..d671fc070ade5640e1c40f9959f3e62f0dfbc425 100644 (file)
--- a/server/sonar-docs/README.md
+++ b/server/sonar-docs/README.md
@@ -66,6 +66,7 @@ order: 0
 scope: static
 ---
 ```
+Metadata tags can appear in any order, but by convention, `title` should come first.
 
 ### Includes
 Basic syntax: `@include tooltips/quality-gates/quality-gate`