News & Blog

2019

Docs-as-Code at JAX conference

less than 1 minute read

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

less than 1 minute read

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

less than 1 minute read

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 ...

Back to Top ↑

2018

Sparxling Wine

less than 1 minute read

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

1 minute read

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

1 minute read

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

1 minute read

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, ...

Back to Top ↑

2017

plantUML revisited

2 minute read

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

1 minute read

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

less than 1 minute read

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)

1 minute read

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

1 minute read

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

1 minute read

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

less than 1 minute read

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

less than 1 minute read

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...

Back to Top ↑

2016

Simple AsciiDoc Build with Maven

1 minute read

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

2 minute read

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 ...

Back to Top ↑