2,065 $−207 $1,858 $
What this module delivers.
How the training runs
- Method
- Document case studies, assess other people's documentation in reviews
- Basis
- Official iSAQB curriculum 2025.1
- Outcome
- 20 credit points, all methodical, no course exam
Dates & booking
Choose a date that fits
8 dates
Sessions with this symbol offer up to 25% group discount. Click “Details & Registration” to learn more.
1,693 $−169 $1,524 $
1,693 $−169 $1,524 $
1,693 $−169 $1,524 $
1,868 $−186 $1,682 $
2,315 $−232 $2,083 $
1,693 $−169 $1,524 $
1,693 $−169 $1,524 $
No dates match this selection.
Dates are still available. Reset the filters to see them.
Fit
Who this module is designed for
Typical roles
- You own how a system's architecture gets described and recorded.
- You inherit large or outdated documentation and have to make it usable again.
- You review other teams' documentation and give them feedback on it.
Prerequisites
No prerequisites
You can start right away. Helpful: hands-on experience creating and maintaining technical documentation, experience with large or outdated bodies of documentation, some exposure to reviewing documents or code.
Consider instead ARCEVAL Works through the named procedures ATAM, CBAM and DCAR for evaluating the architecture itself, and spends 150 of its 570 minutes on scenario-based workshops.
Curriculum
CPSA® ADOC Course in Detail
Curriculum 2025.1 splits ADOC into six parts across 720 minutes, 245 of them exercise time. It runs from the fundamental terms through process, content elements and tools to reviewing documentation somebody else wrote. Real case studies close it, rather than another chapter of theory.
01Fundamental terms of architecture documentation
This part settles what people actually mean when they say architecture documentation.
- The purpose and goals of documentation, seen from each stakeholder's angle
- Where it ends and requirements, user and operations documentation begin
- Notations from UML to the informal sketch, and when each one holds
- Matching documentation effort to the development process in use
02Process for architecture documentation
This part builds the process by which documentation is planned and maintained across a team.
- Identifying target groups and goals before the first page exists
- Setting structure, roles and artifacts for shared maintenance
- Comparing and selecting arc42, C4 and ISO/IEC 42010 as templates
- Identifying application scenarios for GenAI in documentation
03Elements of architecture documentation
The largest part of the curriculum, with as much exercise time as teaching time.
- Building block, runtime and deployment views, and who reads each of them
- Architecture Decision Records carrying the decision and the options rejected
- Cross-cutting concepts, constraints, quality goals and technical risks
- Keeping the individual parts of a document set consistent with each other
04Tools
This part answers what documentation is actually written and maintained with.
- Analog and digital tools, modeling tools and complete tool chains
- Defining requirements on tools and artifacts before anything is selected
- Docs-as-Code with PlantUML and versioning next to the source code
- Applying GenAI tools in support of architecture documentation
05Evaluating documentation
Here you draw the line between a documentation review and an architecture review.
- Checking whether documentation is fit for purpose rather than complete
- Content assessment against formal assessment, each with its own goals
- Writing your own checklists and question catalogues for reviews
- Taking the author, reviewer and facilitator roles in a review
06Examples of software architecture documentation
To close, real documentation is on the table rather than another method.
- Real and representative case studies of documented software architectures
- arc42 by Example, which the curriculum names as an example
- Explaining the advantages and disadvantages of the documentation shown
Outcome
What you will be able to do afterwards
- 01
You separate architecture documentation from other kinds of documentation and choose fitting notations.
- 02
You identify the target groups of a document set and design its structure from them.
- 03
You choose between arc42, C4 and ISO/IEC 42010, and justify the decision.
- 04
You record architecture decisions as Architecture Decision Records, including the options you rejected.
- 05
You apply building block, runtime and deployment views and keep them consistent with each other.
- 06
You set up a Docs-as-Code tool chain and use GenAI tools at defined points in it.
- 07
You build review checklists, run a documentation review and derive improvements from its results.
Credit points toward CPSA-A
- Methodical competence
- 20
- Technical competence
- 0
- Communicative competence
- 0
20 of 70 points toward CPSA-A admission
Certificate of participation
The tecnovy certificate of participation records your attendance of the ADOC training, not a passed examination.
Open the Certificate Showroom tecnovy →≥80%attendance
Why tecnovy
What you get on top with us
01
iSAQB® Accredited Provider
We are an officially accredited Training Provider of the International Software Architecture Qualification Board.
02
Certificate Showroom
Get your certificate of participation and, if you have one, add your exam certificate from E-Learning. Fully automated, beautifully designed. Just for you, only at tecnovy.
03
No Slideshow, Hands-On!
Promised: no PowerPoint marathon. We work in groups, tie theory to practice, and you get real project examples from our experienced trainers plus the exchange with like-minded people.
04
Attend Twice, Pay Once
You are welcome to attend the training online again within a year as a refresher.
05
Learn from Authors
Your instructors are not just trainers, but the authors of the preparatory literature for the iSAQB CPSA-F certification exam and at the same time an active member of the iSAQB Foundation group.
06
Flexible Date Change
If you are not able to attend the course, you can rebook your training free of charge up to one week before the start of the training.
Experiences
What participants say
Why tecnovy? Well, I found available dates for online trainings and I decided to try. After the first one (ADOC) I was already recommending tecnovy to my colleagues. The online trainings are interesting and interactive enough to keep people engaged, even when a training needs multiple days.
FAQs
