All posts tagged with 'AsciiDoc'

Documentation as code, code as documentation


This morning, I read this kind tweet by Raumzeitfalle: @rotnroll666 Just discovered the nice #arc42 based documentation of biking2. Thanks for providing such nice example. Got the hint from @DevBoost that #arc42 might be something helpful. The biking2 example helps a lot! — 📸 Raumzeitfalle 🛶 (@Raumzeitfalle) December 4, 2018 This refers to arc42 by […]

Read the complete article »

Git: Create a new, empty and unrelated branch


I wanted to start publishing to GitHub Pages from my learning and experimenting project simple-meetup. One of the learning scopes of the above project is “code as documentation” and the question to which extend such a project can be used to write articles and generate documentation. In this project I’m using Asciidoctor and the Gradle […]

Read the complete article »

arc42 documentation: Building block intent from JavaDoc


Here’s a quick post to get the week started: Recently I was working on my arc42 example project, enforcing Sun / Oracle coding conventions through Checkstyle and it bugged me that my project was missing several files. While adding them and writing something useful I was happy that I chose good slices that fit […]

Read the complete article »