docToolchain / docToolchain/empty-workshop

Add AsciiDoc workshop exercises for software architecture documentation

Open
#6 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Shell
Stars
5
Forks
38
PR merge metrics
No merged PRs in 30d

Description

This issue proposes adding a set of structured workshop exercises to help participants learn AsciiDoc for software architecture documentation.

The exercises will focus on:
1. Setting up arc42 with docToolchain
2. AsciiDoc basics in the context of architecture documentation
3. Creating architecture diagrams with PlantUML and C4
4. Documenting architecture decisions (ADRs)
5. Quality goals and scenarios
6. Collaboration and CI/CD integration

All exercises will be created as AsciiDoc files with examples, tasks, and bonus challenges.

This will provide workshop participants with a structured learning path that combines AsciiDoc fundamentals with practical architecture documentation concepts.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.