[HADOOP-11495] Convert site documentation from apt to markdown

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.7.0
• Fix Version/s: 2.7.0
• Component/s: documentation
• Target Version/s: 2.7.0
• Assignee: Masatake Iwasaki
• Reporter: Allen Wittenauer
• Created: 21/Jan/15 00:05
• Updated: 31/Jul/17 09:32
• Resolved: 10/Feb/15 21:38

Description

Almost Plain Text (aka APT) lost. Markdown won.

As a result, there are a ton of tools and online resources for Markdown that would make editing and using our documentation much easier. It would be extremely beneficial for the community as a whole to move from apt to markdown.

This JIRA proposes to do this migration for the common project.

Issue Links

• breaks: HADOOP-14702 Fix formatting issue and regression caused by conversion from APT to Markdown
• is related to: HADOOP-11633 Convert remaining branch-2 .apt.vm files to markdown
• is related to: HDFS-7668 Convert site documentation from apt to markdown
• is related to: HADOOP-8427 Convert Forrest docs to APT, incremental
• relates to: YARN-3168 Convert site documentation from apt to markdown