hbase-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Misty Stanley-Jones <mstanleyjo...@cloudera.com>
Subject Re: Feedback request - AsciiDoc Reference Guide POC - HBASE-11533
Date Sat, 10 Jan 2015 01:04:39 GMT
See staged site at http://people.apache.org/~misty/book.html. Feedback
appreciated in the jira.

On Wednesday, January 7, 2015, Misty Stanley-Jones <
mstanleyjones@cloudera.com> wrote:

> I just pushed a feature branch for an AsciiDoc POC, called HBASE-11533.
> See the JIRA too. Please check it out.
> You can do mvn clean pre-site, and look at the docs in target/docs. You
> will get a failure but that's nothing to do with this. If you run the
> following, you should get no failure, and you should have the Docbook and
> Asciidoc docs both built in target/docbkx and target/docs respectively:
> mvn clean package javadoc:aggregate site site:stage -DskipTests
> Have a look at both the output, and the source in src/main/asciidoc. Let
> me know if you'd find that easier to edit than Docbook. Also see the little
> cheat sheet I put together in the "Contributing to the Documentation"
> appendix near the end. There are some potentially huge advantages for us.
> One of them I just found out about today is the ability to include real
> source code (in the real files) in code listings. That means we could
> ensure that our code samples were tested!! I am super excited about this.
> Let me know what you think.

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message