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 want to have something they can mail around and read it without...

Read More

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.

The one I like most is ePub, since it...

Read More

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 so far is pandoc - the universal document converter. It is a command line...

Read More

plantUML with Asciidoctor-pdf

The last few days I had to learn the hard way that plantUML (as part of asciidoctor-diagram) is not a frient of asciidoctor-pdf.

I always thought that having plantUML for HTML rendering up and running with asciidoctor also means that...

Read More

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 not long after I tweeted about the new blog post, Read More

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 pull the hottest stuff from the internet, but have to go through...

Read More

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 that there is a new version, but it is the stable release you’ve...

Read More

Jira to Sparx EA

Sparx Enterprise Architect really shines when you use it to model your architecture by creating connections between elements. If you model your requirements, too, EA let’s you trace your design from the requirement up to the class.

Problem is, when...

Read More

Single-File HTML

Asciidoctor renders good looking HTML pages, but often you don’t have a server to publish the document for others to read. That’s why I render my documents as PDF or publish them to confluence. A single file can easily be...

Read More

Living Documents for Agile Projects

If you describe a solution architecture, your document will be in an unfinished state for a long time. If you are on an agile project, your document will be a living one. There will be always open questions which need...

Read More

The only constant in life is change

Today I will show how to add a change log to your documents. Git is quite good when it comes to log changes, so why not use git to add a table of changes to your document? If your version...

Read More

Beyond HTML

Up until now, the docToolchain build only generates HTML5 output. It looks nice, but sometimes you need different formats. For instance, when you want to share your architecture via mail, a single file format like PDF would be helpful -...

Read More

More about AsciiDoc

With the second blog post of this series, I already mentioned that I love AsciiDoc to create technical documentation, but I didn’t say too much about how to use AsciiDoc.

There is a simple reason for this - other...

Read More

Did you ever wish you had better Diagrams?

Let’s recap what we did so far: in order to kickstart a documentation project, we’ve created a dual gradle / maven asciidoc build with included arc42 template in two languages and easy textual diagram drawing with planUML. That’s already quite...

Read More

Let's add Content!

Through the last blog posts, the build script advanced from a simple asciidoc example to a dual build asciidoc archetype with plantUML.

But when you want to document your project, you also need content. Wouldn’t it be great to have...

Read More

PlantUML with Maven

Let’s add PlantUML to our maven build. I’ll use a slightly different approach. For the gradle build, I referenced the asciidoctor-diagram ruby gem to be used. But there is also a .jar version of it which can be used....

Read More

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

Gradle Integration

Let’s first start with Gradle. I...

Read More

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 IMHO outdated (like writing a letter) and writing modern documentation is not a use case where MS Word shines.

Today...

Read More

Groovy is Java is Groovy...

There still seem to be some Java-Developers who are afraid of mixing their Java codebase with the power of Groovy.

Some time ago, it was a valid argument that the dependency to the groovy-all.jar would blow up the generated application,...

Read More

A Groovy Notebook

From time to time I stumble upon a web application which lets you write notebooks like the ones you know from Mathematica. They let you mix formatted text which explains your code with code snippets. The output of those snippets...

Read More

Serialize a Map as JSON or YAML

When working in a web environment, you often have to transfer arbitrary data like lists or maps as String of the network.

The followin Gist shows how to solve this by serializing a list or map as JSON or YAML....

Read More

Jatumba!

Zwei Tage Javaland liegen gerade hinter mir. Zusammen mit Tobias Kraft hatte ich die tolle Gelegenheit unseren Vortrag über Spock und Geb nochmal vor einem größeren Publikum vorzutragen.

Die zwei Tage waren natürlich vollgepackt mit Vorträgen, gutem Essen und...

Read More

Domain Class Diagrams for Grails Projects

A Grails project can quickly grow into larger applications. In order to still keep an overview, some architecture documentation is quite useful. One of the most useful diagrams to dive into an application is the domain class diagrams which shows...

Read More

A Fool with a Tool is still a Fool...

…but sometimes the tool makes a difference!

I just came back from an interesting 3 day workshop on which I had a first chance to make use of my drawing equipment I bought recently. Originally, I wanted to draw some...

Read More

Spock-Reports with Templates

The new template engine for the Spock-Reports-Plugin is out. Let’s build an asciidoc template with it.

Step 1: configure the plugin

Renato describes this step in detail on the Plugin Homepage. I’ve placed the properties file in Read More

Starting a new Blog

Just started my new blog. I’ve already had several blogs with more or less success, so why do I now start another? First of all because I don’t what to be a ghost developer.

Read More