docs-as-code

Your docs, as code —
from keystroke
to publish.

docToolchain v4 runs directly on the JVM — no Gradle, no daemon, startup in 2–3 seconds. One wrapper script, one config file, powerful output.

Java 17 · no Ruby, no Python
Linux · macOS · Windows
~/my-project — dtcw4
$ curl -Lo dtcw4 https://doctoolchain.org/dtcw4
$ chmod +x dtcw4
$ ./dtcw4 local install doctoolchain
↳ docToolchain ready in 2.4s
$ ./dtcw4 local generateSite
✓ site published → build/microsite
$

One toolchain, from keystroke to publish

The best open-source tools wired into a single, reproducible flow.

01 · write
📝
AsciiDoc
Author in plain text, versioned in Git like the rest of your code.
02 · render
🎨
Asciidoctor
Convert to HTML, PDF and slides with AsciidoctorJ on the JVM.
03 · diagram
📐
PlantUML
Generate architecture diagrams straight from text definitions.
04 · publish
🚀
Confluence
Ship a microsite or push docs directly into your team wiki.
Rebuilt for the GenAI age

Every task reviewed. Legacy retired. Modern ones added.

01⚡

Fast Startup

Direct JVM execution — no Gradle, no daemon. Tasks start in 2–3 seconds instead of 15–30.

02🤖

LLM-native

Structured, section-level document access over MCP via dacli, so an AI can read and edit docs precisely.

03🍎

Native Apple Silicon

Runs natively on ARM64 Macs — no Rosetta, no OrientDB/JNI workarounds. Just JVM and AsciidoctorJ.

04🛡

Modern, Secure Deps

Every dependency upgraded to current versions — fewer known CVEs, continuously scanned with Trivy.

05📦

One Script Setup

Just dtcw4 in your project. It installs docToolchain and runs all tasks — no other files needed.

06🖥

Cross-Platform

Linux, macOS and Windows (WSL2). No Ruby, no Python, no native deps — just Java 17.

Quick start

Four lines. One file in your repo.

Just dtcw4 in your project. It installs docToolchain and runs every task — no other files needed.

Read the install guide →
install.sh 
# grab the wrapper
curl -Lo dtcw4 https://doctoolchain.org/dtcw4
chmod +x dtcw4

# install + build your site
./dtcw4 local install doctoolchain
./dtcw4 local generateSite
Ecosystem

More than a single tool

A growing set of projects for your docs-as-code journey.

lint

AsciiDoc Linter

Keep your documentation clean and consistent with a dedicated AsciiDoc linter.

learn more →
cli

dacli

A command-line interface to simplify and streamline your docs-as-code workflow.

learn more →
arch

Bausteinsicht

Architecture-as-code: define building blocks in JSONC, sync with draw.io diagrams.

learn more →
plugin

diagrams.net for IntelliJ

Edit draw.io diagrams directly inside IntelliJ IDEA without leaving your IDE.

learn more →
template

iSAQB Template

A ready-to-use template for writing your CPSA Advanced Level certification thesis, with a custom PDF theme for the required layout.

learn more →
demo

CI/CD Demo

A demo showing how to integrate docToolchain into your CI/CD pipeline for automated builds.

learn more →

iSAQB® and CPSA® are registered trademarks of the International Software Architecture Qualification Board e. V. This template is a community project and is neither provided nor endorsed by the iSAQB.