# Dokumentation schreiben

## Erzeugen einer Datei

Erstelle eine neue leere `README.md` Datei in einem Ordner, der nach einem Modul des Helfers benannt ist. Als Beispiel kannst Du Dir das Verzeichnis `/de/erweiterung/kostenrechner` anschauen. Dort ist ebenfalls schon ein versteckter Bilderordner. Dort hinein kommen dann Screenshots vom Kostenrechner.

{% hint style="info" %}
Eine README.md wird nicht in der URL auftauchen, Sie wird als eine index.\* behandelt. Ist es notwendig ein Modul in mehrere Seiten zu unterteilen, dann benutze eindeutige kleingeschrieben Namen ohne Sonderzeichen oder Leerstellen
{% endhint %}

Die `/SUMMARY.md` im Wurzelverzeichnis muss dann um diese Datei/Pfad ergänzt werden.

Hier ein Beispiel für die englischen Hinweise zur Doku-Erstellung.

```markdown
* [Helping out](en/guide/README.md)
  * [Github](en/guide/github.md)
  * [Markdown](en/guide/markdown.md)
  * [Write a docu](en/guide/documentation.md)
```

Gitbook rendert daraus die korrekte Struktur und generiert automatisch die Links.

## Struktur

Der Untertitel der Seite selbst erscheint immer am Anfang. Hier ist der Titel dieser Seite

```markdown
---
description: Struktur der Doku und sein Code
---
```

Erst dann kommt die erste Überschrift:

```markdown
# Documentation
```

Von hier an kannst Du einfach schreiben. Wie genau der Code aussehen kann, siehst Du unter


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foe-helper.com/deutsch/anleitung/dokumentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
