Writing e-mail is easy. We do it all the time.
Writing documentation is H-A-R-D. We practically have to force ourselves to do it.
Why, then, do we make it more difficult by burying the content deep in XML or struggling with finicky WSYWIG editors?
What if you could write documentation just as you write email? That’s the idea behind AsciiDoc, one of the most widely used lightweight documentation languages.
AsciiDoc is a plain text syntax designed for humans that makes content easy to edit, read, version and share in raw form or rendered as a myriad of output formats.
AsciiDoc goes beyond other lightweight documentation languages by satisfying even the most advanced semantics and publishing requirements, an ideal shorthand alternative to DocBook.
Using Asciidoctor, a modern implementation of the AsciiDoc processor, you can produce beautiful HTML 5, ePub and PDF output—and even slides! We’ll survey the various libraries and tools in the Asciidoctor ecosystem that help make writing a pleasant experience.
Follow the lead of authors. Drop the angled bracket and discover the zen of writing with Asciidoctor.
Dan is an open source advocate, community catalyst, developer, published author (Seam in Action) and internationally recognized speaker. He is the lead of the Asciidoctor project (asciidoctor.org), serves as the strategic advisor for Arquillian (arquillian.org) and helps promote the JVM as a polyglot Java Champion.
As one of the founders of OpenDevise, Dan works with software communities and businesses to help them discover and cultivate their open source way. (Is there any other way?)
After a long conference day, you’ll likely find Dan enjoying chatting about tech, docs and open source with fellow community members over a Trappist beer or Kentucky Bourbon.
