TOP 5 Software Documentation

[feststelltaste]

Let's find some resources, that really help developers and architects to document their software in the most effective ways with the least amount of time wasted!

[feststelltaste]

https://www.divio.com/blog/documentation/ gives a nice introduction into different types of documentation in the are of software development

[feststelltaste]

The book "Documenting Software Architectures" (https://www.oreilly.com/library/view/documenting-software-architectures/9780132488617/) seems like a reference for architecture documentation. But boy, who want's to read over 600 pages? :-/

[feststelltaste]

The arc42 project (https://arc42.org/documentation/) addresses the pains of architecture documentation by providing a lean approach. A template supports your first steps into the world of effective architecture documentation.

[feststelltaste]

The project around Architectural Decision Records (https://adr.github.io/) gives you advice on the bare minimum of architecture documentation: Documenting decisions that have an influence on your software system.