[
https://issues.apache.org/jira/browse/HBASE-11533?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14101762#comment-14101762
]
Misty Stanley-Jones commented on HBASE-11533:
---------------------------------------------
I have most experience with Docbook, but Cloudera uses DITA internally and it
would make my life easier if HBase docs used DITA. I suspect that other
companies using Hadoop also use DITA, though this may or may not be important
to HBase developers.
The AsciiDoc developer team considered AsciiDoc to be feature-complete before
the AsciiDoctor project came along and started submitting pull requests in
order to facilitate their work. Those pull requests may have influenced the
changes you called out in your comment. I can try to find out how stable the
project truly is at this point if you like, but it is always a concern.
For what it's worth, Docbook 4.5, 5, and 5.1 also introduces several
backward-incompatible syntax changes, and I suspect they are why HBase still
uses Docbook 4.4. Time marches on and you really only want to maintain backward
compatibility for so long.
> 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.2#6252)
