Posts on Software Development and IT Operations

Using AsciiDoc content for the website and other downstream processes is now more powerful than ever!

In 2022, Antora acquired of lot of new skills via its extendable APIs and the new plugins that emerged. In the video for FOSDEM, Fabrice and me show and explain how the content pipeline for Eclipse Che was enhanced using Antora and the Antora plugins Collector and Assembler. There’s also a link to the example repository to see them in action.

(3 minutes read, 30 minutes video)

Are you ready for DevOps? Take the shoelace challenge, and find about your capabilities to

• observe and measure,
• try out new things, and
• change your own way of working!

(6 minutes read + 10 minutes practicing)

After preparing and publishing documentation, how do you get feedback? Do people actually read the docs you publish? Without feedback you will not understand if you’ve written the right content for the right people in the right way.

This blog post summarizes ideas and experiences shared at the Continuous Documentation Regulars. Read on for a comparison together with pro’s and con’s.

(12 minutes read)

How to get the content on a website? Separating it from the technical stuff sounds like a good practice for distraction free writing and focused coding. Can an import statement do the trick to load the content from a markup file?

This blog post explores how content written in the markup language AsciiDoc can be used in a single page web application. It shows a minimal generic setup without using existing content plugins. The examples are based on webpack, NuxtJS and Vue.js. You can adapt the recipes in any project that uses webpack.

(10 minutes read)

AsciiDoc is a markup language for documentation. Asciidoctor is a popular implementation of a rendering engine for AsciiDoc.

Today I’m giving the talk at the JavaZone conference in Oslo. I post the code samples, the slides and a video recording of a previous talk at JavaLand here.

In the talk I share my experiences with Asciidoctor, tips and tricks and hints to style your PlantUML diagrams. I also show how to get most out of Asciidoctor PDF generation using templates and extensions.

I’ll present Nuxt.js at enterJS darmstadt today. I’ll focus loading performance, search engine optimisation and making the site work when sharing content on social media.

Read on to find the slide set.