Build TechDoc Structure (SysSpec vs. Arc42)

[darenegade]

Take SysSpec, remove unnecessary chapters, compare result with arc24 and add missing chapters

---

Beide erscheinen für eine öffentliche Doku etwas überfrachtet und enthalten viele Kapitel, die eher intern ins Betriebshandbuch gehören. Daher hier ein Versuch der Reduktion:

1. Einführung
2. IT-Architektur
3. Querschnittliche Konzepte
4. Schnittstellen
5. Entwurfsentscheidungen

Vielleicht starten wir erstmal eher mit weniger und nehmen Kapitel hinzu, wenn diese uns fehlen.

Das Ziel der TechDoku als UserStory formuliert: Als OpenSource Entwickler*in für die Plattform möchte ich das Gesamtsystem verstehen und Entscheidungen nachvollziehen können, sodass ich schnell einen Überblick bekomme aber auch tiefgreifende Konzepte nachvollziehen kann und damit mich an der Entwicklung der Plattform beteiligen kann.

[darenegade]

SysSpec

[darenegade]

Arc24

[darenegade]

Wir haben aktuell schon eine Struktur, die dem nahe kommt. Darauf bauen wir nun einfach auf: