OpenAPI and AsciiDoc in the Mix
This blog post rounds up on converting OpenAPI specs to AsciiDoc and how this can be brought into the mix of centralized documentation.
Bringing documentation together
This blog post explains how documentation from Doxygen and AsciiDoc can be brought together with the help of AsciiDoxy.
Decision records
This blog post summarizes my experience with architecture decision records (ADR), introduces technical debt records (TDB) and demonstrates how everything can be nicely combined document and culture wise.
Extending Asciidoctor
This blog post explains how Asciidoctor can easily be extended with new macros for custom functionality like collecting versions.
Learnings from using ADR in a real project
This blog is a summary of my experience with ADR in a real-world project.
Aggregate AsciiDoc from multiple repositories
This blog post demonstrates how multiple AsciiDoc documents can be assembled with the help of Antora.
AsciiDoctor, Maven and IntelliJ
This blog post is a reminder how to use the AsciiDoc in IntelliJ in a proper way.
ADR and jqAssistant
This blog post demonstrates how ADR and jqAssistant can be combined to do architecture testing from the actual records.