Hacker News Re-Imagined

FreeBSD has recently switched from DocBook to AsciiDoc for its documentation: https://docs.freebsd.org/en/books/fdp-primer/asciidoctor-pri...

Markdown was also an option but it was missing too many features for a documentation set of this size.

  • 1 month ago

  • @0mp
  • Created a post



@Tomte 1 month

Replying to @0mp 🗣

That's actually a likely switch, since AsciiDoc was specifically designed to optimally support Docbook features. So that switch should be painless.

Reply


About Us

site design / logo © 2021 Box Piper