Commit 40f3fdc6 authored by Kourser's avatar Kourser
Browse files

Documentation bilingue, publiée par GitLab Pages

Un site Docusaurus en français et en anglais : à quoi sert le produit, comment
il marche, comment on l'installe, comment on l'exploite.

Douze pages par langue, écrites et non calquées
  L'anglais n'est pas une traduction mécanique. La copie française dit les
  choses crûment — « une garantie qu'on ne peut contrôler qu'aux conditions de
  celui qui la revendique ne garantit rien » — et un calque perdrait ce qui fait
  la moitié du produit. Chaque page porte le même poids dans les deux langues.

  Le plan suit l'ordre des questions qu'on se pose réellement : à quoi ça sert,
  comment ça marche, comment on le met en service, comment on vérifie.

L'adresse n'est pas écrite en dur
  Docusaurus lit CI_PAGES_URL au moment de la construction. Une adresse figée
  serait fausse chez tout auto-hébergeur qui reprend ce dépôt — et ce produit
  est fait pour être repris.

La documentation ne part pas si les garanties tombent
  Deux étapes : « verifier » puis « publier », la seconde dépendant de la
  première. Publier une documentation depuis une révision qui ne tient pas ses
  garanties reviendrait à documenter un produit qui n'existe pas. La suite
  complète tourne dans la CI — typecheck, 602 garanties, couverture des accords
  de contribution.

Ce que la documentation dit et qu'aucune plaquette ne dirait
  Qu'aucun mécanisme de sauvegarde n'est intégré. Qu'une restauration jamais
  éprouvée est une hypothèse. Qu'un journal en ajout seul ne se purge pas, et
  que c'est la contrepartie de la valeur probante. Qu'il ne faut pas installer
  Kastell dans le périmètre qu'il doit secourir. Que le délai réglementaire ne
  court pas depuis l'ouverture de l'outil.

  Ces avertissements sont la partie utile : ils évitent des mises en service
  qui échoueraient le jour J.

Les liens morts font échouer la construction — dans une documentation de crise,
un lien mort est un défaut, pas un détail.

Signed-off-by: default avatarKourser <contact@kourser.bzh>
Co-Authored-By: default avatarClaude Opus 5 <noreply@anthropic.com>
parent 7473187c
Loading
Loading
Loading
Loading