# Namenskonventionen

Gute Namen machen Shortcuts selbsterklärend. Schlechte Namen sorgen dafür, dass sie nicht genutzt werden. Beim Erstellen eines Shortcuts trägst du den Shortcut-Namen in das Feld **Slug** ein. Er wird Teil der Shortcut-URL.

## Erlaubte Zeichen

Shortcut-Namen sind 1–50 Zeichen lang. Sie dürfen Kleinbuchstaben (a–z), Ziffern (0–9), Bindestriche und Unterstriche enthalten. Der Name muss mit einem Buchstaben oder einer Ziffer beginnen und enden.

- Kleinbuchstaben (a–z)
- Zahlen (0–9)
- Bindestriche (-) als Trenner zwischen Wortteilen (z. B. `urlaub-antrag`)
- Unterstriche (_) innerhalb des Slugs

Großbuchstaben werden automatisch in Kleinbuchstaben umgewandelt. Leerzeichen sind nicht erlaubt. Emojis und andere Sonderzeichen werden abgelehnt.

## Eindeutigkeit und Schreibweise

Jeder Shortcut hat einen kanonischen Namen im Feld **Slug**, plus optionale [Aliase](/de/docs/shortcut-aliases) in Business und Enterprise. `all-hands` und `allhands` sind weiterhin zwei verschiedene Shortcuts, wenn du beide anlegst. Einigt euch im Team auf eine Schreibweise und bleibt dabei. Bindestriche sind die gängigste Konvention, weil sie in URLs üblich und gut lesbar sind.

## Länge

Das Zeichenlimit liegt bei 50 Zeichen. Kürzere Namen lassen sich leichter merken. Ein bis drei Wörter sind ein guter Richtwert.

Einige Beispiele:

| Statt | Besser |
| --- | --- |
| `/urlaubsantrag-formular` | `/urlaub` |
| `/quarterly-business-review-deck` | `/qbr` |
| `/engineering-standup-notizen` | `/standup` |
| `/interne-wissensdatenbank-wiki` | `/wiki` |

## Sprache

Eine Hauptsprache für kanonische Slugs im Workspace wählen. In internationalen Teams ist Englisch die gängigste Wahl. In Teams, in denen alle dieselbe Sprache sprechen, funktioniert die Landessprache genauso gut.

Wenn Kolleginnen und Kollegen unterschiedliche Wörter für denselben Link brauchen, [Aliase](/de/docs/shortcut-aliases) ergänzen statt Shortcuts zu duplizieren — zum Beispiel `/vacation` mit `/urlaub` und `/ferien`.

## Präfixe

Für Workspaces mit vielen Shortcuts kann ein leichtes Präfix helfen, Links nach Bereich zu ordnen:

- `/hr-urlaub`, `/hr-gehalt`, `/hr-benefits`
- `/it-vpn`, `/it-passwort`, `/it-ticket`
- `/eng-deploy`, `/eng-runbook`, `/eng-oncall`

Tiefe Hierarchien wie `/hr/recruiting/bewerbung/formular` vermeiden. Niemand merkt sich den vollständigen Pfad, und Abteilungsnamen ändern sich.

Wenn ein Begriff allein eindeutig genug ist (`/vpn`, `/roadmap`, `/wiki`), das Präfix weglassen.

## Alternative Namen

Nutze [Shortcut-Aliase](/de/docs/shortcut-aliases), wenn ein Ziel mehr als einen Handle braucht — Abkürzungen, Tippfehler-Fänger oder Sprachvarianten. Einen kanonischen Slug behalten und Aliase für den Rest ergänzen, damit Analysen und Bearbeitungen an einem Ort bleiben.

## Aufräumen

Shortcuts vierteljährlich prüfen. Nach Links suchen, die in den letzten 90 Tagen nicht geklickt wurden, Links, die auf Seiten zeigen, die nicht mehr existieren, und Namen, die sich überschneiden oder in Konflikt stehen. Tote Shortcuts zu entfernen hält die Bibliothek vertrauenswürdig und macht Suchergebnisse nützlicher.