hbase-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Nick Dimiduk (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HBASE-11533) AsciiDoctor POC
Date Thu, 08 Jan 2015 02:16:35 GMT

    [ 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)

Mime
View raw message