Einführung

Mordoc ist ein Dokumentationswebsite-Generator, der Ihre Inhalte in saubere, elegante und hochgradig benutzerfreundliche Dokumentationswebsites verwandelt.

Sie schreiben Markdown-Inhalte und einfache Konfigurationsdateien, und Mordoc kümmert sich um den Rest: Navigation, Layouts, Styling und Struktur. Das Ergebnis ist eine vollständig funktionsfähige Dokumentationswebsite, die von Anfang an professionell wirkt.

Warum Mordoc?

Es gibt viele großartige Dokumentationswerkzeuge, und viele von ihnen leisten bereits ausgezeichnete Arbeit. Also… warum noch eines?

Viele Dokumentationswerkzeuge bieten reichhaltige Schreiberfahrungen, werden aber häufig mit gehosteten Plattformen, proprietären Editoren oder starren Workflows geliefert. Andere bieten leistungsstarke Grundlagen, erwarten aber von Teams, dass sie alles selbst zusammenbauen. Jede Organisation ist anders, und diese Ansätze passen nicht immer.

Mordoc verfolgt einen anderen Ansatz. Es bietet einen Open-Source-Dokumentationsgenerator, der es Teams ermöglicht, Inhalte als Code zu pflegen und sie auf jeder Infrastruktur ihrer Wahl zu veröffentlichen. Mit der bereits eingebauten Dokumentationsapp und den Komponenten können Inhaltsautoren sofort mit einfacher, leicht erlernbarer Syntax beginnen zu schreiben.

So sieht das in der Praxis aus.

Inhalt als Code

Mordoc behandelt Inhalt als Code, ohne Autoren zu zwingen, wie Entwickler zu denken. Ihre Inhalte liegen in Dateien vor, sodass Änderungen nachverfolgt und überprüft werden können, die Versionshistorie explizit ist und die Zusammenarbeit natürlich mit Ihrem Team skaliert, genau wie bei einer Codebasis. Sie erhalten die Vorteile moderner Änderungsverwaltung, während die Schreiberfahrung leichtgewichtig und fokussiert bleibt.

Inhalt zuerst, komponentengetrieben

Mordoc nutzt Markdown, die beliebteste Syntax zum Schreiben von Inhalten, und stellt zusätzlich die integrierten, individuellen Dokumentationskomponenten bereit, die Sie brauchen (Karten, Callouts, Code-Blöcke, Tabellen und mehr), indem es auf Markdoc aufbaut. Es gibt nichts, das Sie vor dem Schreiben zusammenbauen müssen, und einmal installiert, können diese Komponenten überall durch klare, lesbare Syntax wiederverwendet werden.

Das lässt Inhaltsautoren die Freiheit, sich auf Struktur und Klarheit statt auf Implementierungsdetails zu konzentrieren, und hält die Dokumentation über Seiten und Mitwirkende hinweg konsistent, auch wenn mehr Menschen daran schreiben. Die Syntax selbst ist bewusst begrenzt und vorhersehbar, gestaltet, um leicht zu erlernen, leicht zu lesen und langfristig leicht zu pflegen zu sein.

Keine Anbieterabhängigkeit

Ihre Dokumentation gehört Ihnen. Hosten Sie sie überall, veröffentlichen Sie sie auf jeder beliebigen Infrastruktur und wechseln Sie jederzeit, ohne auch nur ein Wort des Inhalts neu schreiben zu müssen. Mordoc generiert Dokumentationswebsites. Es sperrt Ihre Inhalte nicht in einer Plattform ein.

Für die Zusammenarbeit entwickelt

Mordoc ist so konzipiert, dass sich Inhaltsersteller auf Schreiben und Struktur konzentrieren können, während Entwickler nur bei Bedarf für Einrichtung und Infrastruktur einspringen. Diese Trennung der Aufgaben macht Dokumentation einfacher zu skalieren und einfacher zu pflegen.

Open Source by Design

Mordoc ist Open Source und transparent: keine Black Boxes, kein verstecktes Verhalten, nur Community-getriebene Verbesserungen. Sie können es untersuchen, verstehen, wie es funktioniert, und Ihren Dokumentations-Workflow an Ihre Bedürfnisse anpassen.

Neugierig, wie es funktioniert? Legen wir los.

Nächster Schritt

• Einen Code-Editor installieren. Es ist ein hilfreiches Werkzeug, und Sie müssen nicht programmieren.