iSAQB CPSA Advanced Level · Module ADOC

Document Efficiently, Communicate Clearly

Your Foundation for Sustainable Software Architectures
◷ Duration: 2 Days ◆ In-Person and Online Training
iSAQB CPSA Advanced Level · Module ADOC

Communicate Architecture Effectively for Your Target Audience and Document It Efficiently

Stay in control even in complex projects.

During the training, you will learn how to document software architectures effectively, tailor documentation to specific target audiences, evaluate it, and communicate it clearly. In addition to technical aspects, the training also covers the essential organizational and social factors of architecture documentation.

Sustainable Architecture Documentation

The importance of good architecture documentation is often underestimated in new IT projects. However, documenting the software architecture plays a crucial role in making developments and changes throughout the project traceable and understandable.

It also supports communication within the project team as well as with customers and partners. This also makes designing the software system easier.

What Can You Expect?

In the “ADOC” module of the iSAQB Advanced Level, you will learn through practical exercises how to create and optimize architecture documentation and ensure its quality.

You will gain knowledge of notations, tools, and methods for documenting architectural decisions and quality requirements and learn how to select appropriate tools.

By the end of the training, you will be able to create architecture documentation for medium-sized to large IT systems.

Prerequisites for Participants

  • You should have basic knowledge from CPSA-F, such as architectural views, design decisions, and constraints.
  • Ideally, you already have experience creating and maintaining technical documentation.
  • You have a basic understanding of typical challenges such as selecting notations and integrating tools.
  • Experience collaborating on documentation is an advantage.
  • Knowledge of versioning and documentation processes will make it easier for you to get started.

Technical Requirements

There are no special requirements for the training environment, as the exercises use cloud-based and web-based tools such as Miro, Draw.io, and platforms such as Jupyter or HuggingFace. All that is required is a stable and sufficiently fast internet connection.

Your Added Value

You will learn how to systematically create and evaluate architecture documentation and develop it further for specific target audiences.

01

Document Systematically

You will learn how to document software architectures systematically.

02

Improve Documentation

You will be able to evaluate existing documentation and improve it in a targeted way.

03

Consider Target Audiences

You will take different needs into account and adapt the documentation accordingly.

04

Tools & Templates

You will use tools and templates such as arc42 and C4 for efficient documentation.

05

Practical Techniques

You will receive practical examples and techniques for addressing real-world challenges.

06

Improve Quality

You will use reviews and feedback to improve documentation quality.

Training Content in Detail

Fundamentals, methods, tools, and proven approaches for professional architecture documentation.

01

Fundamentals of Software Architecture Documentation

  • Benefits, objectives, and stakeholder requirements
  • Notations such as UML and BPMN and the influence of development methods
02

Documentation and Approach

  • Structuring and creating architecture documentation
  • Standardized templates: arc42, C4, ISO/IEC 42010, IEEE 1471
03

Components of Architecture Documentation

  • Architectural decisions, architectural views, and quality requirements
  • Consistency and traceability of documentation
04

Tools

  • Analog and digital tools for documentation
  • Modeling tools, wikis, version control, and word processing
05

Evaluating Documentation

  • Review methods
  • Checklists
  • Quality assurance
06

Examples of Software Architecture Documentation

  • Presentation and analysis of real-world architecture documentation
  • Comparison of different documentation approaches
  • Discussion of the advantages and disadvantages of different documentation methods

Your Benefits at a Glance

✦

Structured and Efficient Documentation

Clear and traceable architecture records for all stakeholders.

↗

Improved Quality

Improved consistency and traceability through proven methods and tools.

◈

Optimized Collaboration

Consistent documentation standards make team communication and coordination easier.

Further Information

Curriculum

The iSAQB curriculum provides further information about the learning objectives and training content.

↓ Download Curriculum
%

Early-Bird Discount

€100 discount up to 6 weeks before the training starts.

Time or Location Not Suitable?

We are happy to organize a dedicated online training course for your team or deliver the training directly at your company!

Credit Points for CPSA-A Certification

By completing the ADOC training, participants earn 20 methodological credit points under the iSAQB Advanced Level program.

20 methodological
Credit Points

Training Formats

Choose between in-person classroom training and interactive live online training.

⌂

In-Person Training

  • Training documents and exercise materials included
  • Cold and hot drinks, snacks, and lunch on all training days
  • Modern, spacious training rooms for a comfortable learning environment
◉

Live Online Training

  • Training documents and exercise materials included
  • Visual collaboration, e.g. through whiteboarding
  • A high degree of interactivity through adapted exercises and breakout rooms
  • Excellent trainer support, including in breakout rooms
ITech Academy

Our Trainers

Experienced trainers guide you through the ADOC training with a strong practical focus and teach the key concepts of architecture documentation, target-audience-oriented communication, and sustainable software architectures.

Our Trainers

Feedback from the Training

“

What was particularly helpful for me was learning not to view architecture documentation merely as an obligation, but as a tool for making decisions transparent, understandable, and usable in the long term.

— Participant feedback on the ADOC training

“

My main takeaway is how important it is to adapt architecture content to different target audiences. The combination of documentation and clear communication was particularly valuable for my day-to-day work.

— Participant feedback on the ADOC training

“

The practical methods and tools showed me how architecture documentation can be created in a more structured way, reviewed systematically, and developed efficiently in everyday project work.

— Participant feedback on the ADOC training

Document and Communicate Software Architecture Clearly

In the iSAQB Advanced Level Module ADOC, learn how to create architecture documentation in a structured way, tailor it to specific target audiences, and use it sustainably in your projects.

Send a Written Inquiry →

Open Dates and Registration

Here you will find our current open training dates. Choose your preferred date and register directly for the ADOC training.

Would you like customized in-house training?

Do you have an entire team that you want to train, but none of our courses fit your needs? No problem! We are happy to create a customized in-house training program in collaboration with you, whether for beginners or advanced learners. We look forward to your inquiry!

Request+49 621 595702-41