[CORD-2585]
Additional documentation and lint fixes

Change-Id: I47c0683a71697acd31c55c2f9e34689cdc670dea
diff --git a/docs/mdlstyle.rb b/docs/mdlstyle.rb
index ce1c0a6..f738818 100644
--- a/docs/mdlstyle.rb
+++ b/docs/mdlstyle.rb
@@ -1,12 +1,15 @@
 # use all rules
 all
 
-# Intent lists with 4 spaces
+# Indent lists with 4 spaces
 rule 'MD007', :indent => 4
 
 # Don't enforce line length limitations within code blocks and tables
 rule 'MD013', :code_blocks => false, :tables => false
 
-# numbered lists should have the correct order
+# Numbered lists should have the correct order
 rule 'MD029', :style => "ordered"
 
+# Allow  ! and ? as trailing punctuation in headers
+rule 'MD026', :punctuation => '.,;:'
+