From bed7a2edba2abce048e3419a97c654c40e863efc Mon Sep 17 00:00:00 2001
From: "G. Ann Campbell" <ann.campbell@sonarsource.com>
Date: Fri, 27 Jul 2018 11:59:24 -0400
Subject: [PATCH] add detail about Table of Contents

---
 server/sonar-docs/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/server/sonar-docs/README.md b/server/sonar-docs/README.md
index d671fc070ad..54819f5e8e8 100644
--- a/server/sonar-docs/README.md
+++ b/server/sonar-docs/README.md
@@ -109,8 +109,8 @@ this content is displayed on <!-- sonarcloud -->SonarCloud<!-- /sonarcloud --><!
 
 ### Page-level ToC
 Basic syntax: `## Table of Contents`
-Lists all h2 & h3 
-
+Lists all h2 & h3  
+The resulting table of contents will also list all h1 items, but h1 is used for the page title, and by convention should not also be used further down the page.
 
 ### Formatting
 #### Links
-- 
2.39.5