✨️ New blog post: "STF Milestone 10: Documentation improvements"

Modernizing #JUnit's documentation by adopting #Antora and hosting on @statichost

👉️ https://marcphilipp.de/blog/2026/01/25/stf-milestone-10-documentation-improvements/

Thanks to the @sovtechfund for their support!

STF Milestone 10: Documentation improvements • Marc Philipp

Personal website

I'm going to have to write my own #AsciiDoctor-based static site generator, right?

I still haven't found anything that fits my use case, coming from #ikiwiki, which I want to leave because it's slow, written in Perl (not my favorite language) and doesn't integrate well with AsciiDoctor.

#Antora manages to both be overengineered for my use case *and* miss essential features like feed generation. Also node.js, no thanks

1/2

#SSG

Für mein neues Projekt habe ich diesmal die Architekturdokumentation nach #arc42 mit #Antora aufgebaut. Documentation as Code in seiner Reinform.

@xwiki how about making documentation part of your source code? And on top of that, have an acceptance criteria for pull requests: documentation is updated.

Does not make perfect documentation, but at least it significantly reduces documentation rot.

And thanks to #antora, docs from several repositories can be aggregated into one single webpage.

Wile not an option for everything, this is a solution for when things are tracked in a version control system like git.

🛠️ Diagramm oder Doku? Warum nicht beides!

Unser CEO @madmas zeigt am 12. Mai auf der betterCode() ArchDoc, wie Architekturdiagramme und Dokumentation gemeinsam entstehen – mit PlantUML, AsciiDoc & Antora, automatisiert via GitLab CI.
Ideal für alle, die Architektur dokumentieren, ohne doppelte Arbeit zu machen. Oder Chaos. 😉
🔗 https://archdoc.bettercode.eu/veranstaltung-83492-se-0-diagramm-oder-doku-warum-nicht-beides.html

#DocsAsCode #SoftwareArchitecture #PlantUML #AsciiDoc #Antora

betterCode() ArchDoc 2025 - Online-Event für Softwarearchitekten

heise-Konferenz für Softwarearchitektinnen und -architekten: moderne und praktische Dokumentationsmethoden mit und ohne KI. Anerkannten Experten und Diskussion.

betterCode() ArchDoc 2025

Coming from #MkDocs on #ReadTheDocs , I think about migrating our projects user manual to #Asciidoc using #asciidoctor and/or #antora .

But I wonder if there is a service like #readthedocs for #asciidoc based manuals available for #OpenSource or #foss projects.

Important is that those platforms do support @Codeberg (#forgejo aka #gita ) code hosting, instead of Microsoft GitHub.

Switching to Antora for the OliveTin docs was the best thing ever for the docs. Now just added support for doc tabs with a simple extension :-) #asciidoc #antora thanks Dan Allen!
I've been spending a bunch of evenings migrating to a new documentation system for OliveTin - #antora, fixing dead links, improving formatting, and overall design of the docs: https://docs.olivetin.app/ #opensource #selfhosted #homelab
OliveTin Introduction :: OliveTin docs

Softwareprojekte konsistent mit Antora dokumentieren

Mit Antora können Sie ganze Dokumentationen für statische Websites auf Basis von AsciiDoc über mehrere Repositorys hinweg strukturieren und konsistent halten.

iX Magazin
Just in case someone with some #Antora #AsciiDoc and maybe #PlantUML experience is around: I've a question: https://github.com/madmas/demo-antora-doc-A/issues/1 #plsretoot #retoot
PlantUML diagram references not rendering as expected in Antora/Asciidoc/PlantUML using Kroki · Issue #1 · madmas/demo-antora-doc-A

Question about rendering PlantUML diagrams using Kroki in Antora. This is the sample project to demonstrate the problem: https://github.com/madmas/demo-antora-doc-A Rendered Antora page can be foun...

GitHub