Seminar Docusaurus – Informationsarchitektur, Navigation und Sidebars

Inhaltsübersicht

1. Zielsetzung
2. Schritt 1: Zielgruppen und Top-Aufgaben analysieren
3. Schritt 2: Inhaltstypen und Taxonomie festlegen
4. Schritt 3: Ordner, IDs und Slugs entkoppeln
5. Schritt 4: Sidebar-Modell entwerfen
6. Schritt 5: Globale Navigation gestalten
7. Schritt 6: Landingpages und Querverweise aufbauen
8. Schritt 7: Versionen und Sprachen berücksichtigen
9. Schritt 8: Struktur testen und pflegen
10. Praxisphasen
11. Zielgruppe und Voraussetzungen

Zielsetzung

Das Seminar entwickelt eine auf Aufgaben und Zielgruppen ausgerichtete Informationsarchitektur für Docusaurus. Taxonomie, Dokument-IDs, Slugs, Kategorien, Sidebars, Navbar, Landingpages, Querverweise und langfristige Änderungsregeln werden gemeinsam geplant und praktisch umgesetzt.

• Zielgruppen, Aufgaben und Inhaltsarten in eine belastbare Struktur überführen
• Dokument-IDs, Slugs und Ordner unabhängig voneinander sinnvoll einsetzen
• manuelle und automatisch erzeugte Sidebars kontrolliert kombinieren
• Navigation durch Tests, Kennzahlen und Pflegekonventionen dauerhaft stabil halten

Seminarinhalte

Schritt 1: Zielgruppen und Top-Aufgaben analysieren

Die Struktur beginnt mit Nutzungsszenarien und nicht mit vorhandenen Ordnern. Häufige Aufgaben, Wissensstände und Entscheidungspunkte werden in priorisierte Nutzerpfade übersetzt.

• primäre Zielgruppen und Nutzungskontexte erfassen
• Top-Aufgaben und Einstiegspunkte priorisieren
• unterschiedliche Wissensstände berücksichtigen

Schritt 2: Inhaltstypen und Taxonomie festlegen

Tutorials, Aufgabenanleitungen, Konzepte, Erklärungen und technische Detailseiten erhalten eindeutige Rollen. Kategorien und Begriffe werden begrenzt, definiert und in einer gemeinsamen Taxonomie gepflegt.

• Inhaltstypen mit Zweck und Mindeststruktur beschreiben
• Begriffe, Synonyme und Produktnamen harmonisieren
• Überlappungen und doppelte Inhalte identifizieren

Schritt 3: Ordner, IDs und Slugs entkoppeln

Physische Ablage, interne Dokument-ID und öffentliche Route werden bewusst getrennt. Dadurch bleiben Links und Navigation stabil, auch wenn Dateien oder redaktionelle Zuständigkeiten verschoben werden.

• Namenskonvention für Dateien und IDs definieren
• sprechende und stabile Slugs festlegen
• Änderungen mit Weiterleitungen absichern

Schritt 4: Sidebar-Modell entwerfen

Automatisch erzeugte Sidebars eignen sich für konsistente Hierarchien, manuelle Sidebars für kuratierte Lern- und Aufgabenpfade. Beide Varianten werden so kombiniert, dass Wartbarkeit und redaktionelle Kontrolle erhalten bleiben.

• Kategorien und Reihenfolge planen
• autogenerierte Bereiche begrenzen
• mehrere Sidebars nach Inhaltsdomänen trennen

Schritt 5: Globale Navigation gestalten

Navbar, Footer, Dokument-Sidebar, Breadcrumbs und Inhaltsübersicht erhalten klar getrennte Aufgaben. Wiederholungen werden vermieden und besonders wichtige Einstiege bleiben auf kleinen Ansichten erreichbar.

• globale und lokale Navigation unterscheiden
• Versions- und Sprachauswahl sinnvoll positionieren
• mobile Navigation und Tastaturbedienung prüfen

Schritt 6: Landingpages und Querverweise aufbauen

Landingpages erklären Bereich, Zielgruppe und nächste Schritte, statt nur Listen anzuzeigen. Querverweise verbinden Voraussetzungen, Folgeaufgaben und verwandte Konzepte ohne unübersichtliche Linkteppiche.

• Bereichslandingpage mit Entscheidungslogik entwerfen
• Vorher-nachher-Pfade zwischen Aufgaben dokumentieren
• kontextreiche Linktexte und kurze Linkgruppen verwenden

Schritt 7: Versionen und Sprachen berücksichtigen

Informationsarchitektur wird auf Versions- und Sprachvarianten geprüft. Navigation darf keine Inhalte aus unpassenden Ständen mischen und übersetzte Strukturen müssen trotz Abweichungen verständlich bleiben.

• Versionsgrenzen und gemeinsame Inhalte kennzeichnen
• lokalisierte Bezeichnungen und Reihenfolgen planen
• fehlende Übersetzungen kontrolliert behandeln

Schritt 8: Struktur testen und pflegen

Aufgabenbasierte Tests zeigen, ob Inhalte gefunden und Navigationsentscheidungen verstanden werden. Strukturänderungen erhalten Regeln, Eigentümerschaft und eine regelmäßige Bereinigung veralteter Kategorien.

• Such- und Navigationsaufgaben mit Testpersonen formulieren
• Abbrüche, Sackgassen und unnötige Ebenen erfassen
• Pflegezyklus und Freigabe für Strukturänderungen definieren

Praxisphasen

Die einzelnen Arbeitsschritte werden an einer durchgängigen Übungsplattform umgesetzt. Konfigurationen, Inhalte und Prüfungen werden schrittweise erweitert und jeweils mit einem produktionsnahen Build kontrolliert.

• Erstellung einer Zielgruppen- und Aufgabenmatrix für ein Dokumentationsportal
• Entwurf einer Taxonomie mit Ordnern, IDs, Slugs und kombinierten Sidebars
• Aufbau und Test einer Landingpage mit eindeutigen Nutzerpfaden

Zielgruppe und Voraussetzungen

Zielgruppe: Informationsarchitekten, technische Redaktionen, UX-Verantwortliche, Product Owner und Docusaurus-Administratoren

Voraussetzungen: Grundkenntnisse in Docusaurus und Markdown; Erfahrung mit bestehenden Dokumentationsstrukturen ist hilfreich