Spring's Getting Started Guides migrated to Asciidoctor
"If Markdown is a 1st-grader, then AsciiDoc is a PhD student."[sic] -- Dan Allen, project lead of AsciiDoctor
We recently migrated all of our Getting Started Guides to Asciidoctor. Why? Because Asciidoctor provides so many valuable features!
- Several built in directives make it possible to pull in entire code files, small fragments of code, and external chunks of reusable content.
- Rendering is now embedded into spring.io's website.
- No need to "generate" the guide, which always puts you at risk of being out of sync with the code, the build files, and the document itself.
- Lines up with how many of our projects are migrating away from DocBook towards AsciiDoctor to reduce maintenance. …