Useful Resources

Underlying Technologies

Markup

AsciiDoc

Our preferred markup language for technical docs.

Markdown

jBake also supports Markdown via flexmark-java.

Templates

arc42

Docs as Code

Docs as Code

Static Site Generator

jBake
  • jBake — drove generateSite in v3; v4 uses a built-in generator (MicrositeBaker)

  • Docsy — the standard theme in v3; v4 ships Bootstrap 5 GSP templates

  • Bootstrap 5 — CSS framework

Books

Title Author Language

Docs Like Code

Anne Gentle

English

arc42 by Example

Gernot Starke, Stefan Zörner, Michael Simons, Ralf D. Müller

English

Communicating Software Architectures with arc42

Gernot Starke, Peter Hruschka

English