Aller au contenu principal

Guide de style du Satellite Spectrum Handbook

Ce guide de style établit les règles de rédaction, de mise en forme, de référencement et de traduction du contenu du Satellite Spectrum Handbook. Ces règles sont appliquées par nos agents automatisés et sont obligatoires pour tous les contributeurs.

1. Ton et style de langue​

  • Facile à comprendre : Écrivez dans un anglais clair et simple (ou dans la langue cible correspondante). Évitez le jargon administratif ou juridique trop dense. Lorsque des termes techniques (par exemple, NGSO, epfd, mise en service) doivent être utilisés, expliquez-les immédiatement à l'aide d'analogies.
  • Factuel & Objectif : Tout le contenu doit être strictement objectif, factuel et éducatif.
  • Aucun biais commercial : Absolument aucun marketing, placement de produit, promotion personnelle ou formulation biaisée. Ne recommandez pas et ne faites pas l'éloge d'opérateurs commerciaux, de lanceurs ou de fabricants de matériel spécifiques, sauf s'ils sont requis comme contexte factuel (par exemple, mentionner Starlink de SpaceX ou OneWeb uniquement comme exemples de méga-constellations non géostationnaires).
  • Inclusif & Neutre : Évitez les biais régionaux. Ne supposez pas que le lecteur ne s'intéresse qu'aux réglementations de la FCC américaine ; équilibrez avec l'UIT-R, l'Ofcom (Royaume-Uni), l'ISDE (Canada) et d'autres administrations mondiales.

2. Mise en forme et Markdown (MDX)​

  • Encadrés (Admonitions) : Utilisez les encadrés natifs de Docusaurus pour mettre en évidence les règles ou conseils importants : 
    :::important
    Il s'agit d'une étape réglementaire critique.
    :::
  • Diagrammes : Utilisez des blocs Mermaid pour expliquer des configurations orbitales complexes ou des flux de travail de dépôt de dossiers :
    • Mise en forme Mermaid & Palette de couleurs :
      • Centrage : Les diagrammes Mermaid doivent toujours être centrés horizontalement sur la page.
      • Pas de défilement horizontal : Gardez les diagrammes simples et verticaux afin qu'ils s'intègrent proprement sur les écrans mobiles et de bureau. Divisez les diagrammes complexes ou denses en plusieurs diagrammes plus petits placés séquentiellement.
      • Thème consolidé : Tous les éléments Mermaid sont stylisés globalement via src/css/custom.css. N'utilisez pas de styles en ligne ou de couleurs personnalisées aléatoires dans les codes de diagramme individuels, sauf pour les bordures de mise en page cleanNode des sous-graphes.
      • Modèle de sous-graphe : Pour les sous-graphes dans les diagrammes Mermaid, définissez et appliquez toujours le modèle cleanNode pour garder les arrière-plans transparents et utiliser une bordure bleu foncé propre :
      • Palette visuelle : Les sous-graphes utilisent (classDef cleanNode fill:none,stroke:#102a43,stroke-width:1px;) avec une bordure Slate propre (#cbd5e1/#475569), remplaçant les arrière-plans jaune/or vif par défaut. Les nœuds utilisent un remplissage blanc/slate foncé avec des bordures Slate et des coins arrondis.

3. Exigences SEO​

Chaque chapitre doit être hautement optimisé pour les moteurs de recherche afin de garantir sa visibilité auprès des professionnels de la réglementation et des débutants :

  • Titre : Moins de 60 caractères, riche en mots-clés et unique.
  • Description : Moins de 160 caractères. Doit résumer fidèlement le chapitre et inclure naturellement des mots-clés cibles (par exemple, "licences de spectre satellite", "processus de coordination de l'UIT").
  • Hiérarchie des titres :
    • Le titre de la page dans le frontmatter génère l'unique <h1> de la page.
    • N'utilisez pas de # dans le corps du texte. Commencez les titres du corps par ## (H2) et les sections imbriquées par ### (H3).
  • Liens internes : Liez les pages en utilisant un texte d'ancrage descriptif (par exemple, Découvrez les [droits d'atterrissage](./landing-rights.md)). N'utilisez jamais de phrases génériques comme "cliquez ici" ou "en savoir plus".

4. Références & Liens externes​

Toutes les déclarations réglementaires doivent être référencées afin de maintenir la crédibilité professionnelle :

  • Format : Indiquez l'administration ou l'organisme, suivi de la réglementation spécifique ou du nom du document de recommandations.
  • Exemples :
    • Règlement des radiocommunications de l'UIT, Article 9 (Édition 2020)
    • FCC Title 47 CFR Part 25
    • Ofcom Space Spectrum Strategy (2022)
  • Liens : Fournissez des liens directs vers des sites publics officiels (par exemple, ITU.int, FCC.gov, Ofcom.org.uk) où les lecteurs peuvent télécharger ou lire les documents sources. Assurez-vous que les liens sont permanents et sécurisés (HTTPS).

5. Navigation de fin de chapitre & Contenu connexe​

Chaque page du manuel doit se terminer par une section de navigation standard pour guider le lecteur :

---

## Étapes suivantes
* **Sujet suivant** : [Nom du chapitre suivant](./next-chapter-file.md) - Brève phrase décrivant ce que couvre le chapitre suivant.
* **Concepts connexes** :
  - [Concept A](./another-file.md) - Explication rapide de la relation.
  - [Concept B](./yet-another-file.md) - Explication rapide.
* **Lectures complémentaires** :
  - [Guide de dépôt de l'UIT](https://www.itu.int/...) - PDF de référence ou portail.