Werde Teil unseres Teams und sorge für mehr Digitale Souveränität!
- Teamleiter IT – Kundenprojekte (m/w/d)
- IT Consultant (m/w/d)
- Senior Backend / Software Developer Python (m/w/d)
- u.v.m.

Die Dokumentationsfamilie für Univention-Produkte ist um ein neues Mitglied gewachsen, die Univention Corporate Server Architecture. Sie finden das Dokument online und zum Download als PDF. Es ist die erste Iteration eines viel größeren Dokumentationsprojekts, das die technische Architektur hinter Univention Corporate Server (UCS) auf verschiedenen Detailebenen für unterschiedliche Zielgruppen abdeckt.
Inhaltsverzeichnis
Die erste Iteration richtet sich an Consultants, Administrierende, Lösungsarchitekt*innen, Softwareentwickler*innen und Systemingenieure, die sich einen Überblick über die Positionierung von UCS in der IT-Welt und die verschiedenen Konzepte hinter UCS wie z.B. Domäne, Rollen und Berechtigungen verschaffen wollen.
Ziel ist es, ein umfassendes Verständnis für die technische Architektur von UCS zu vermitteln, so dass dieser Personenkreis IT-Anwendungsfälle besser abdecken und IT-Umgebung mit UCS planen und betreiben können. Das Dokument soll auch Softwareentwickler*innen und Systemingenieuren ermöglichen, schneller in die Softwareentwicklung für UCS einzusteigen.
Wir haben uns aus mehreren Gründen für einen iterativen Schreibprozess entschieden:
Die übliche Vorgehensweise beim Schreiben von Dokumenten wie der Architektur für UCS gliedert sich in mehrere Prozessschritte wie Planen, Schreiben, Überprüfen und Veröffentlichen. Leider braucht der daraus resultierende Inhalt eine gewisse Zeit bis zur Veröffentlichung, wenn das Dokument alle Schritte als Ganzes durchläuft. Potenzielle Leser*innen können erst dann von den Inhalten profitieren, wenn das Projekt abgeschlossen ist. Dieser Ansatz ähnelt dem Wasserfallmodell in der Softwareentwicklung.
Für die agile Softwareentwicklung verwenden wir bei Univention das Kanban-Framework, um in selbstorganisierenden und funktionsübergreifenden Teams zu arbeiten, und um adaptive Planung und kontinuierliche Verbesserung zu nutzen. Warum nicht dieselben Prinzipien aus der Softwareentwicklung auch für die Erstellung von Produktdokumentationen anwenden?
Mit der UCS-Architekturdokumentation experimentieren wir mit einem anderen Ansatz und liefern gleichzeitig frühzeitig geprüfte Inhalte. Bereits vor Projektbeginn haben wir den Veröffentlichungsschritt automatisiert, da er auch für andere Univention-Dokumentationen gilt. Zu Beginn des Projekts haben wir die Struktur des gesamten Dokuments geplant. Mit der Automatisierung können wir den Veröffentlichungsschritt so oft wie nötig wiederholen, ohne dass zusätzlicher Arbeitsaufwand anfällt.
Die Schritte Schreiben und Überprüfen beinhalten die Arbeit an den Inhalten, die dem Leser Nutzen bringen. Sie gehören zusammen. Aber wie können wir den Nutzen für den Leser und die Leserin früher erreichen? Wir haben uns die Zielgruppen und den geplanten Inhalt angesehen. Wir beschlossen, den Inhalt in Abschnitte aufzuteilen, die den verschiedenen Zielgruppen entsprechen, so dass jede Iteration einer anderen Zielgruppe des Dokuments einen Nutzen bringt.
Wir haben zwei zusätzliche Detailebenen für das Dokument geplant. Die zweite Detailebene richtet sich an Administrierende und Lösungsarchitekt*innen. Sie behandelt die UCS-Produktkomponenten und die zahlreichen Services, die UCS für IT-Infrastrukturen bietet. Die dritte Detailebene richtet sich an Softwareentwickler und Systemingenieure und behandelt die Softwarebibliotheken, die internen Systeme und den Storage.
Mit zunehmender Detailtiefe wird sich auch das benötigte Wissen der Leser*innen von der Informationstechnologie im Allgemeinen, den Bausteinen für Rechnernetze und Software über Linux-Betriebssysteme und deren Administration bis hin zu Kenntnissen über Softwarearchitektur und Software-Engineering erweitern.
Sobald wir weitere Inhalte veröffentlichen, finden Sie die Ankündigung in diesem Blog und auf unseren Kommunikationskanälen. Sie dürfen gespannt sein, was noch alles auf Sie zukommt.
Ihr Feedback zur UCS-Architekturdokumentation ist willkommen und wird sehr geschätzt. Wenn Sie Kommentare, Anregungen oder Kritik haben, senden Sie uns bitte Ihr Feedback, damit wir das Dokument in einer der nächsten Iterationen verbessern können. Vielen Dank.
Nico Gulden studierte angewandte Informatik und arbeitet seit 2010 bei Univention. Als Technical Editor ist er verantwortlich für Ausbau und Pflege der Produktdokumentation. In seiner Freizeit widmet er sich seiner Familie, dem Lesen, der Bewegung an der frischen Luft zum Radfahren, Fotografieren, Geocaching und der Kinder- und Jugendarbeit.