Easy Diagrams with Kroki
News & Blog
2021
2020
Back to Top ↑2019
Docs-as-Code at JAX conference
Come and visit my talk at the JAX conference in Mainz! Laut mehrerer Umfragen ist fehlende #Dokumentation ein großes Hindernis für den Einsatz von #OpenS...
HtmlSanityCheck at OOP conference
For the second time, we were happy to present the Docs-as-Code approach to a broad audience of experts with a real example. HtmlSanityCheck is not only a ce...
arc42 by Example
The second edition of arc42 by Example has just been released. The new edition contains as new example the arc42 architecture of docToolchain! We just ...
2018
Sparxling Wine
In order to optimize docToolchain for Mac and Linux, I wanted to give Sparx Enterprise Architect a try on a *nix environment. I once already tried to inst...
How to use tabs in AsciiDoc
While writing a tutorial, I just came across the need to target two different user groups - windows and linux users. I wanted to write some shell commands a...
AsciiDoc Image Size
When you work with several output formats for your doucments, it can be quite hard to get the size of oyur images right. Most of the time, you will use la...
Colorful Gradle
Did you ever whished to change the color of your gradle log output? Maybe to highlight something? AFAIK, Gradle has no support for colors out of the box, ...
2017
plantUML revisited
Two days ago, a plantUML tweet caught my attention: Someone is willing to pay for a plantUML diagram. That’s something I haven’t seen before...
Do more with Slides
As an architect, you often have to present your ideas and architecture to an audience. Powerpoint might seem to be a perfect fit for that, but people also w...
Turn your Document into an Audio-Book
Last blog post showed you how to convert your asciidoc into .docx via docbook. Pandoc can do more than that. It has a lot of target format under the hood....
Render Asciidoc to docx (MS Word)
docToolchain is currently able to render your documents as HTML and PDF. But sometimes you just need a different format. The best solution I’ve found ...
Enterprise Asciidoctor
Last time I wrote about how to configure Gradle to run behind a proxy with a local binary repository. First, I have to say that I love twitter, because ...
Behind the great Firewall
The open internet is a great place to code, but sometimes you are sitting behind a great firewall in a corporate environment. Your are not allowed to just...
Handle Dependency Updates the easy Way
Every developer knows this problem - you work on a project and over time new versions of the configured dependencies are released. Sometimes it is even not ...
Automated Quality-Checks
Now that docToolchain handles your docs like your code, the next logical step is to add some automated tests. That’s where htmlSanityCheck, a projec...
2016
Simple AsciiDoc Build with Maven
Last time we created a Gradle project to render an AsciiDoc file. But what if you can’t use Gradle but have to use Maven? Let’s add a pom.xm...
Simple AsciiDoc Build with Gradle
So I told you to use AsciiDoc to write technical documents because of all the great features. Today I want to show you how to unleash the power and get ...
Why you should use AsciiDoc to document your Software Solution
Last time I wrote about why I don’t like Word, but I didn’t mention an alternative. For me, AsciiDoc as markup language is a perfect altern...
Why No Word
Why I don’t like Word to write documentation Don’t get me wrong – MS Word is a great product for many use cases, but most of them are IM...