1Willkommen

Dieses Dokument ist eine sinngemäße Übersetzung. Maßgeblich ist das Originaldokument auf Französisch; Erweiterungen und Änderungen werden stets dort eingepflegt.

Dieses Dokumentations-Kit gibt es in zwei Formen, die einander ergänzen: als Papierordner und als Website. Beide enthalten dieselbe Referenzdokumentation, jeweils im passenden Format — der Ordner für eine eigenständige Lektüre, die sich ohne jeden Rechnerzugang weitergeben lässt, die Website für den schnellen Zugriff von jedem Gerät aus, mit anklickbarer Navigation und Dokumenten, die sich mit einem Griff kopieren lassen.

Beide Formen sind zusammen entstanden. Keine ist die Hauptfassung der anderen.

Dieser Leitfaden hilft Ihnen, sich zurechtzufinden — ob Sie das Kit zum ersten Mal öffnen, ein laufendes Projekt übernehmen oder verstehen möchten, wie das Ganze funktioniert.

2So finden Sie sich zurecht

Die Dokumentation ist in thematische Rubriken gegliedert, jede mit einer eigenen Farbe. Das ist eine einfache optische Orientierung — Sie müssen sich keine Nummern merken, die Farbe genügt, um eine Rubrik auf einen Blick wiederzufinden. Im Ordner sind es die Registerblätter, auf der Website die farbigen Abschnitte der Startseite. In beiden Formen dieselbe Logik.

Die Lesereihenfolge hat der Autor festgelegt, und sie ist nicht beliebig. Beginnen Sie mit der ersten Rubrik und gehen Sie der Reihe nach vor. Jeder Schritt gibt Ihnen, was Sie für den nächsten brauchen.

3Der Aufbau im Überblick

Das Deckblatt des Ordners und die Startseite der Website zeigen dieselben Rubriken mit ihren Farben und dieselben Dokumente. Von dort aus finden Sie ein bestimmtes Dokument. Die Stylesheets und die Betriebsdateien stehen in keinem der beiden: Sie liegen im herunterladbaren Archiv.

Ihre Feingliederung weicht leicht voneinander ab, und das ist gewollt: der Ordner führt alles auf, was Sie in Händen halten, die Website fasst zusammen, was online veröffentlicht ist. Ein Widerspruch ist das nicht.

4Die Dokumente Rubrik für Rubrik

Hier erfahren Sie, was Sie in jeder Rubrik dieses Ordners finden und wozu jedes Dokument dient. Die Rubriken erscheinen in der Reihenfolge, in der sie hinter den farbigen Registerblättern liegen.

4.1Bevor Sie anfangen

Die Einstiegsdokumente. Wie man seine Projekte dokumentiert behandelt die Entscheidungen, die der ersten geschriebenen Zeile vorausgehen: was Sie erhalten wollen, für wen, und die organisatorischen Festlegungen, die den weiteren Verlauf bestimmen. Der Leseleitfaden, den Sie in Händen halten, erklärt den Gebrauch des Ordners und die Reihenfolge, in der die Rubriken anzugehen sind.

4.2Arbeiten mit Claude AI

Alle Dokumente dieses Ordners sind mit Unterstützung einer künstlichen Intelligenz entstanden. Das Kit hängt von keinem Anbieter ab: Es legt Formatierungsregeln und eine Produktionskette fest, und jedes Modell wendet sie in seiner Umgebung an. Es folgt eine Rubrik je dokumentiertem Modell: Claude AI, Grok AI, ChatGPT AI.

Jede Rubrik versammelt, was ihrem Modell gehört. Das Handbuch stellt es vor und beschreibt seine Eigenheiten; der Praxisleitfaden gibt die Sitzungsreflexe; die Umgebungsaufnahme sagt, was seine Kette bietet und was ihr fehlt; die Gesprächsbefehle ergänzen, sofern das Modell sie liefert, was ihm eigen ist.

Lesen Sie die Rubrik des Modells, das Sie verwenden. Der Umgebungsvertrag selbst nennt kein Modell: Er gehört zu den Dateien und zur Struktur, §4.7.

Claude AI: Handbuch, Praxisleitfaden und Umgebungsaufnahme.

4.3Arbeiten mit Grok AI

Grok AI: Handbuch, Praxisleitfaden, Umgebungsaufnahme und modelleigene Gesprächsbefehle.

4.4Arbeiten mit ChatGPT AI

ChatGPT AI: Praxisleitfaden und Umgebungsaufnahme.

4.5Ein Projekt starten und pflegen

Diese Rubrik enthält die praktischen Leitfäden des Kits. Der Einrichtungsleitfaden beschreibt die Schritte, um ein neues Projekt in wenigen Minuten zu starten. Der Aktualisierungsleitfaden erklärt, wie eine weiterentwickelte Fassung des Kits in ein bestehendes Projekt eingespielt wird, ohne die laufende Arbeit zu berühren. Die Namenskonvention legt die Benennungsregeln aller Dateien fest. Beim Start und bei jeder Weiterentwicklung des Systems heranzuziehen.

4.6Die künstliche Intelligenz führen und das Kit anpassen

Zwei Arten, die Führung zu übernehmen. Die Gesprächsbefehle werden in den Chat kopiert, um eine Sitzung zu rahmen oder sie zurückzuholen, wenn sie abdriftet; sie wirken auf den Assistenten, während der Arbeit.

Das Kit erweitern wirkt auf das Kit selbst: wie eigene Darstellungen hinzugefügt werden, ohne die des Kits zu ändern, wohin Ihre Dateien gehören, und was bricht, wenn das Kit sich weiterentwickelt. Zu lesen, wenn das Kit einen Bedarf nicht abdeckt.

4.7Dateien und Struktur

Der Projekt-Prompt eröffnet diese Rubrik. Ein Prompt ist hier keine im Chat gestellte Frage: es ist ein Dokument dauerhafter Regeln, einmal im Arbeitsbereich hinterlegt und vom Assistenten zu Beginn jeder Sitzung gelesen. Es trägt, was nie wiederholt werden soll — das zu verwendende Stylesheet, die Namenskonvention, die Sprache, den Autor, die vor jeder Lieferung verbindliche Prüfkette. Es ist das Stück, das das Ergebnis von Sitzung zu Sitzung reproduzierbar macht.

Der Vertrag der Ausführungsumgebung gehört in diese Rubrik. Er sagt, was die Kette verlangt, was wegfällt, wenn eine Fähigkeit fehlt, und welche Prüfung zu Beginn jeder Sitzung zu wiederholen ist. Er nennt kein Modell: Die Aufnahme jedes Modells steht in seiner eigenen Rubrik.

Der Rest der Rubrik versammelt die förmliche Beschreibung des Kits — seine Dateien, ihre Rollen und ihre Abhängigkeiten. Sie finden dort das Dokument zur gemeinsamen Struktur, das alle Dateien eines Projekts mit ihren Verträgen aufführt, die Dokumentation der Web-Veröffentlichung und die der Qualitätssicherung. Heranzuziehen, wenn Sie verstehen möchten, wie das Kit gebaut ist.

Das Glossar beschließt die Rubrik: die Fachbegriffe des Kits, in Alltagssprache erklärt, mit einem Beispiel, wo es hilft. Die Begriffe erscheinen im Fließtext der übrigen Dokumente kursiv und farbig, was anzeigt, dass hier eine Erklärung steht.

4.8Ein Projekt veröffentlichen und teilen

Das letzte Registerblatt behandelt, was auf die Dokumentation folgt: sie online zu zeigen und übernehmbar zu machen. „Veröffentlichung und Übernahme“ beschreibt, was eine Subsite ihren Lesern zeigt, was sie außerhalb dieser Darstellung bewahrt und unter welcher Bedingung dieser zweite Teil öffentlich wird.

5Wer tiefer einsteigen möchte

Dieser Ordner ist die gedruckte Fassung eines digitalen Dokumentationssystems. Die Dokumente darin sind aus den Dateien eines eigenen Arbeitsbereichs entstanden, mit Unterstützung einer künstlichen Intelligenz.

Wenn Sie dieses System selbst in die Hand nehmen möchten — um neue Dokumente zu erstellen, bestehende Inhalte zu aktualisieren oder das Projekt weiterzuentwickeln —, beschreiben die Rubriken hinter dem Leseleitfaden das Vorgehen.

Wenn Sie nicht weitergehen möchten, liest sich dieser Papierordner ohne jeden Zugriff auf die Dateien.

Das vollständige Kit lässt sich als Archiv von der Website herunterladen: die Dokumente in allen Sprachen, die Stylesheets, die Generatoren und die Prüfwerkzeuge. Damit lässt sich das Ganze auf dem eigenen Rechner weiterführen. Die Stylesheets liegen dort mit ihren Reference-Dokumenten — General, Glossary, YAML und HTML —, die jede Formatierungsfunktion mit ihrem Erscheinungsbild zeigen.