From 4d7df801282da9c581e06d775e530bbc61b2ab9a Mon Sep 17 00:00:00 2001
From: Sean Madsen <sean@seanmadsen.com>
Date: Wed, 25 Jan 2017 17:57:46 -0700
Subject: [PATCH] markdownrules - making header language more strict

---
 docs/markdownrules.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/markdownrules.md b/docs/markdownrules.md
index 9d1a0a7e..b82774c8 100644
--- a/docs/markdownrules.md
+++ b/docs/markdownrules.md
@@ -103,9 +103,10 @@ This is a second.
 ```
 
 The above syntax is [called](http://pandoc.org/MANUAL.html#headers)
-"ATX style headers" in markdown terminology, and is preferred my most.
+"ATX style headers" in markdown terminology, and is the [preferred](#standards)
+syntax within the CiviCRM community.
 An alternate syntax called "setext style headers" works for h1 and h2 as
-follows:
+follows (but please avoid creating new content with this syntax).
 
 ```md
 Heading 1
-- 
GitLab