# Bereiche einrichten

> Name, Adresse, Symbol, Art, Leseansicht und die weiteren Einstellungen eines Bereichs.

Neue Bereiche legst du in der Seitenleiste mit **Neuer Bereich** an. Die Einstellungen eines bestehenden Bereichs
öffnest du über das Zahnrad neben dem Bereichsnamen (oberhalb der Seitenliste). Dafür brauchst du im Bereich die
Rolle *Bereichs-Admin* (Workspace-Admins haben sie immer).

## Beim Anlegen

| Feld | Bedeutung |
|---|---|
| **Symbol** | Eines der Symbole aus der Auswahl – erscheint in der Verwaltung und auf der Website |
| **Name** | Anzeigename, z. B. „Handbuch“ |
| **Adresse** | Erster Teil der URL (`/handbuch/…`). Leer lassen = automatisch aus dem Namen |
| **Beschreibung** | Kurzer Text für Startseite und Bereichsübersicht |
| **Art** | *Dokumentation*, *Changelog* oder *API-Referenz* – lässt sich später nicht ändern |
| **Sichtbarkeit** | Siehe [Sichtbarkeit](doc:sichtbarkeit) |
| **Passwort (nur bei Passwortschutz)** | Nur nötig bei *Passwortgeschützt* |
| **Sprache** | Hauptsprache der Inhalte (Deutsch, English, Français, Español, Italiano, Nederlands) |

:::info[Reservierte Adressen]
Einige Adressen sind für das System reserviert und können nicht als Bereichsadresse verwendet werden, z. B. `admin`,
`api`, `auth`, `search`, `feed`, `v`, alles mit `_` am Anfang sowie Sprachkürzel wie `de` oder `en`.
:::

## Einstellungen eines Bereichs

**Allgemein** – Symbol, Name, Adresse und Beschreibung. Achtung: Eine geänderte Adresse bricht bestehende Links auf
den Bereich.

**Zugriff** – Sichtbarkeit, Passwort, die **Rolle für Workspace-Mitglieder** und die **Review-Pflicht**. Details in
[Sichtbarkeit](doc:sichtbarkeit), [Rollen](doc:rollen) und [Änderungsanfragen](doc:aenderungsanfragen).

**Leseansicht** – was Leser neben dem Text sehen:

- *Inhaltsverzeichnis rechts*
- *Zurück/Weiter-Links* am Seitenende
- *„War das hilfreich?“-Feedback* (Auswertung unter [Statistik & Feedback](doc:statistik-und-feedback))

Nach dem **Speichern** wird der Bereich neu generiert.

**Teilen & Rollen** – Personen und Gruppen Zugriff geben, siehe
[Mitglieder & Gruppen](doc:mitglieder-und-gruppen).

**Versionen** – den aktuellen Stand einfrieren, siehe [Versionen & Sprachen](doc:versionen-und-sprachen).

**Freigabe-Links** – nur bei nicht-öffentlichen Bereichen, siehe [Freigabe-Links](doc:freigabelinks).

**OpenAPI-Spezifikation** – nur bei Bereichen der Art *API-Referenz*, siehe
[OpenAPI-Referenz](doc:openapi-referenz).

## Changelog-Bereiche

Ein Changelog-Bereich zeigt datierte Einträge, die neuesten zuerst, und bietet unter
`/<bereich>/feed.xml` einen RSS-Feed an. Im Editor hat jede Seite eines Changelog-Bereichs zusätzlich ein Feld
**Datum**.

Statt die Einträge von Hand anzulegen, kannst du eine `CHANGELOG.md` importieren (per [CLI](doc:cli) oder
[REST-API](doc:rest-api)). Docsello versteht Abschnitte der Form `## 1.2.0 – 2026-10-01` (auch
„Keep a Changelog“: `## [1.2.0] - 2026-10-01`) mit Unterüberschriften wie `### Neu`, `### Verbessert`,
`### Behoben` bzw. `### Added`, `### Changed`, `### Fixed`. Jede Version wird ein Eintrag; ein erneuter Import
aktualisiert nur, was sich geändert hat. Abschnitte „Unreleased“ werden standardmäßig übersprungen.