[ 
https://issues.apache.org/jira/browse/HADOOP-11495?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14284719#comment-14284719
 ] 

Karthik Kambatla commented on HADOOP-11495:
-------------------------------------------

I don't know much about winning and losing, but I like that markdown reads well 
on github and developers could benefit from reading the latest (trunk/branch-2) 
documentation in a browser.

That said, it would be nice for someone involved in earlier discussions around 
APT to weigh in. And, it is preferable to change all sub-projects in the same 
release. 

> Convert site documentation from apt to markdown
> -----------------------------------------------
>
>                 Key: HADOOP-11495
>                 URL: https://issues.apache.org/jira/browse/HADOOP-11495
>             Project: Hadoop Common
>          Issue Type: Improvement
>    Affects Versions: 3.0.0
>            Reporter: Allen Wittenauer
>         Attachments: HADOOP-11496-00.patch
>
>
> 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.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to