Docs-as-Code – Alles unter einem Dach
Im ersten Teil dieser Artikelreihe haben wir Ihnen den Docs-as-Code-Ansatz erläutert. Im zweiten Teil zeigten wir, wie Sie durch Automatisierung weitere Build-Schritte erzeugen, die Ihnen die Dokumentation erleichtern.
Dabei lag unser Fokus immer auf einem einzelnen Dokument. Die Dokumentation Ihres Teams wird hingegen aus einer Vielzahl unterschiedlicher Dokumente bestehen. Die offensichtlichen sind die Architekturdokumentation, ein Benutzerhandbuch und ein Entwicklerhandbuch. Betrachtet man andere Systeme, so spielt auch immer eine Landingpage als Einstieg in das System und ein Blog für aktuelle Informationen eine große Rolle. Ein Menü zur einfachen Navigation bildet schließlich die Klammer um all diese Dokumente (s. Abb. 1).
In diesem Artikel – dem dritten Teil der Serie – zeigen wir Ihnen, wie Sie mit Hilfe eines Static Site Generators alle benötigten Dokumente unter ein Dach bringen und eine Micro-Site für Ihr System bauen.
0 Kommentare