documentation clean-up and remove commented-out code for WEB-8147 +review WEBCR-205
use noninitial to match how MW Parser.php escapes ids when constructing headers for WEB-8146 +review WEBCR-205