Architecture Documentation – iSAQB Advanced Level Curriculum (ADOC)

Status

This is copyrighted work.

About this curriculum

This repository contains the source of the iSAQB^® Advanced Level (CPSA-A) curriculum Architecture Documentation (module ADOC). The goal of this module is to equip architects with the knowledge and capabilities to create and maintain effective architecture documentation of software systems.

The curriculum is written in AsciiDoc and built into versioned PDF and HTML output in German (DE) and English (EN). It was created from the iSAQB Advanced Level template.

Released documents

The latest released HTML and PDF documents (German and English) are published via GitHub Pages at public.isaqb.org/curriculum-adoc.

They are produced by CI on each release. Pre-rendered translations in other languages (if any) live in docs-ext/ – see docs-ext/EXTERNAL_DOCUMENTS_README.adoc.

Version history

Version	Date	Comments
2025.1	2025	Updated references, included docs-as-code, included LLMs/AI (see changelog.md for details). Consistent wording for learning goals.
2021.1	2021	Major content overhaul, migrating to AsciiDoc, first English version. Several updated learning goals.
1.6-DE	2018	Minor fixes, not synchronized with EN version
1.5-EN	2018	Preliminary translation
1.5-DE	2018	Minor update of German version

How to build locally

Prerequisite: Docker. Nothing else — no JDK, no Ruby.

Clone the repository (with submodules, for the license text):

git clone git@github.com:isaqb-org/curriculum-adoc.git --recursive

If you already cloned without --recursive, run git submodule update --init --recursive.

Build all languages and formats:

./curriculum-build.sh        # Linux / macOS
curriculum-build.bat         # Windows

Build a single output — pass the format and language (and optionally a variant):

./curriculum-build.sh pdf DE          # Linux / macOS
./curriculum-build.sh html EN
./curriculum-build.sh pdf DE REMARKS

curriculum-build.bat pdf DE           rem Windows
curriculum-build.bat html EN
curriculum-build.bat pdf DE REMARKS

Output is written to build/, named <CURRICULUM_FILE>-<lang>.pdf / .html, together with an index.html overview page. The launcher pulls the builder image on first run and reuses it afterwards.

Build configuration

build.config in the repository root holds the per-curriculum settings:

Key	Meaning
CURRICULUM_FILE	AsciiDoc root in docs/ (without .adoc); also the output file name.
LANGUAGES	Space-separated languages to build. Default DE EN; drop one for a single-language curriculum.
SUFFIX_TAGS	Space-separated extra build variants, exposed as the {suffix} attribute. Empty = single build.
PREPRESS	PDF print/book layout (recto chapter starts + binding margins). true / false.

Any key can be overridden for a single run via an environment variable, e.g. LANGUAGES="DE" ./curriculum-build.sh.

How to contribute or participate

Create an issue, a merge- or pull-request.

Licensing and Copyright

license-copyright/LICENSE.adoc