Looks great. You want us to just move over to asciidoctor wholesale Misty for all branches (0.98+)?
St.Ack On Fri, Jan 9, 2015 at 5:04 PM, Misty Stanley-Jones < [email protected]> wrote: > See staged site at http://people.apache.org/~misty/book.html. Feedback > appreciated in the jira. > > On Wednesday, January 7, 2015, Misty Stanley-Jones < > [email protected]> 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. > > >
