Thanks Allen. You are right, the github renderer does have trouble rendering the headers. I was only looking at the html generated by mvn site, which did not have trouble rendering them. Anyway I added a space after all the hashes and it looks ok through github now.
-Gour On 9/5/17, 3:20 PM, "Allen Wittenauer" <a...@effectivemachines.com> wrote: > >> On Sep 5, 2017, at 3:12 PM, Gour Saha <gs...@hortonworks.com> wrote: >> >> 2) Lots of markdown problems in the NativeServicesDiscovery.md document. >> This includes things like Œyarnsite.xml¹ (missing a dash.) >> >> The md patch uploaded to YARN-5244 had some special chars. I fixed those >> in YARN-7161. > > > It’s a lot more than just special chars I think. Even github (which has >a way better markdown processor than what we’re using for the site docs) >is having trouble rendering it: > >https://github.com/apache/hadoop/blob/51c39c4261236ab714fe0ec8d00753dc4c64 >06ee/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/na >tive-services/NativeServicesDiscovery.md > >e.g., all of those ‘###’ are likely missing a space. >