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

Nick Dimiduk commented on HBASE-11533:
--------------------------------------

I'm all for a simpler syntax than docbook. I've done some blogging with 
markdown and I like it well enough, my only complaint is it doesn't handle 
inline content very nicely (images). Does asciidoc fix this kind of thing? It's 
good that it has growing support, though if I look at readthedocs.org getting 
started section, they say markdown or reStructuredText.

Kudos [~misty] for tackling this and extra bonus points if it actually takes 
*less* time to render the docs that then java source.

> AsciiDoctor POC
> ---------------
>
>                 Key: HBASE-11533
>                 URL: https://issues.apache.org/jira/browse/HBASE-11533
>             Project: HBase
>          Issue Type: Sub-task
>          Components: build, documentation
>            Reporter: Misty Stanley-Jones
>            Assignee: Misty Stanley-Jones
>            Priority: Minor
>             Fix For: 2.0.0
>
>
> Convert or create a subset of documentation in Asciidoc and integrate 
> Asciidoctor into the Maven build. http://asciidoctor.org/
> Get some folks to play around with it afterward.



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

Reply via email to