Zum Hauptinhalt springen

Leitfaden für das Satellitenspektrum-Handbuch

Dieser Leitfaden legt die Regeln für das Schreiben, Formatieren, Referenzieren und Übersetzen von Inhalten für das Satellitenspektrum-Handbuch fest. Diese Regeln werden von unseren automatisierten Agenten durchgesetzt und sind für alle Mitwirkenden obligatorisch.

1. Ton und Sprachstil​

  • Leicht verständlich: Schreiben Sie in klarem, einfachem Deutsch. Vermeiden Sie allzu dichten Verwaltungs- oder Juristendeutsch. Wenn technische Begriffe (z. B. NGSO, epfd, Inbetriebnahme) verwendet werden müssen, erklären Sie diese sofort anhand von Analogien.
  • Sachlich & Objektiv: Alle Materialien müssen streng objektiv, sachlich und lehrreich sein.
  • Keine kommerzielle Voreingenommenheit: Absolut keine Werbung, Produktplatzierung, Selbstdarstellung oder voreingenommene Formulierungen. Empfehlen oder loben Sie keine bestimmten kommerziellen Betreiber, Trägersysteme oder Hardwarehersteller, es sei denn, sie sind als sachlicher Kontext erforderlich (z. B. die Erwähnung von SpaceX Starlink oder OneWeb rein als Beispiele für nicht-geostationäre Mega-Konstellationen).
  • Inklusiv & Neutral: Vermeiden Sie regionale Voreingenommenheit. Gehen Sie nicht davon aus, dass sich der Leser nur für die US-amerikanischen FCC-Vorschriften interessiert; halten Sie das Gleichgewicht mit ITU-R, Ofcom (UK), ISED (Kanada) und anderen globalen Behörden.

2. Formatierung & Markdown (MDX)​

  • Admonitions (Hinweisboxen): Verwenden Sie die nativen Docusaurus-Hinweisboxen, um wichtige Regeln oder Tipps hervorzuheben: 
    :::important
    Dies ist ein kritischer regulatorischer Meilenstein.
    :::
  • Diagramme: Verwenden Sie Mermaid-Blöcke, um komplexe orbitale Konfigurationen oder Anmelde-Workflows zu erklären:
    • Mermaid-Formatierung & Farbpalette:
      • Zentrierung: Mermaid-Diagramme müssen auf der Seite immer horizontal zentriert sein.
      • Kein horizontales Scrollen: Halten Sie die Diagramme einfach und vertikal, damit sie auf Mobil- und Desktop-Ansichten sauber passen. Teilen Sie komplexe oder dichte Diagramme in mehrere kleinere, nacheinander platzierte Diagramme auf.
      • Konsolidiertes Thema: Alle Mermaid-Elemente werden global über src/css/custom.css gestaltet. Verwenden Sie keine Inline-Styles oder zufälligen benutzerdefinierten Farben in den einzelnen Diagrammcodes, außer für die cleanNode-Layoutgrenzen von Subgraphen.
      • Subgraph-Vorlage: Definieren und wenden Sie für Subgraphen in Mermaid-Diagrammen immer die cleanNode-Vorlage an, um die Hintergründe transparent zu halten und einen sauberen dunkelblauen Rand zu verwenden:
      • Visuelle Palette: Subgraphen verwenden (classDef cleanNode fill:none,stroke:#102a43,stroke-width:1px;) mit einem sauberen Slate-Rand (#cbd5e1/#475569), der die standardmäßigen hellgelben/goldenen Hintergründe ersetzt. Knoten verwenden eine saubere weiße/dunkelgraue Füllung mit Slate-Rändern und abgerundeten Ecken.

3. SEO-Anforderungen​

Jedes Kapitel muss für Suchmaschinen hochgradig optimiert sein, um die Sichtbarkeit für Regulierungsexperten und Einsteiger zu gewährleisten:

  • Titel: Unter 60 Zeichen, reich an Schlüsselwörtern und einzigartig.
  • Beschreibung: Unter 160 Zeichen. Muss das Kapitel genau zusammenfassen und Ziel-Schlüsselwörter (z. B. "Satellitenspektrum-Lizenzierung", "ITU-Koordinationsprozess") natürlich enthalten.
  • Überschriftenhierarchie:
    • Der Seitentitel im Frontmatter erzeugt das einzige <h1> auf der Seite.
    • Verwenden Sie kein # im Fließtext. Beginnen Sie die Überschriften im Text mit ## (H2) und verschachtelte Abschnitte mit ### (H3).
  • Interne Verlinkung: Verlinken Sie Seiten unter Verwendung von beschreibendem Ankertext (z. B. Lesen Sie mehr über [Senderechte](./landing-rights.md)). Verwenden Sie niemals generische Ausdrücke wie "hier klicken" oder "mehr erfahren".

4. Referenzen & externe Links​

Alle regulatorischen Aussagen müssen referenziert werden, um die fachliche Glaubwürdigkeit zu wahren:

  • Format: Nennen Sie die Behörde oder das Gremium, gefolgt von der spezifischen Verordnung oder dem Namen des Empfehlungsdokuments.
  • Beispiele:
    • ITU Vollzugsordnung für den Funkdienst Artikel 9 (Ausgabe 2020)
    • FCC Title 47 CFR Part 25
    • Ofcom Space Spectrum Strategy (2022)
  • Links: Stellen Sie direkte Links zu offiziellen öffentlichen Websites (z. B. ITU.int, FCC.gov, Ofcom.org.uk) bereit, auf denen die Leser die Quelldokumente herunterladen oder lesen können. Stellen Sie sicher, dass die Links dauerhaft und sicher (HTTPS) sind.

5. Navigation am Kapitelende & verwandte Inhalte​

Jede Handbuchseite muss mit einem Standard-Navigationsabschnitt enden, um den Leser zu führen:

---

## Nächste Schritte
* **Nächstes Thema**: [Name des nächsten Kapitels](./next-chapter-file.md) - Kurzer Satz, der beschreibt, was das nächste Kapitel abdeckt.
* **Verwandte Konzepte**:
  - [Konzept A](./another-file.md) - Kurze Erklärung der Beziehung.
  - [Konzept B](./yet-another-file.md) - Kurze Erklärung.
* **Weitere Lektüre**:
  - [ITU-Leitfaden zur Anmeldung](https://www.itu.int/...) - Referenz-PDF oder Portal.