TODO

Documentation technique

D’après le document de référence fourni, avant de commencer le développement à proprement parler (le cycle par objet ou par tranche), il y a une étape préliminaire obligatoire appelée Phase 0 : Préparation.

Voici la to-do liste exacte à réaliser avant toute chose (cette phase est indiquée comme étant “à faire une seule fois”) :

Phase 0 : Préparation (Les prérequis fondamentaux)1/3

Finaliser la matrice de dépendances entre les objets

Action : Cartographier l’ensemble des composants du projet pour identifier leurs liens.
Livrable : Un tableau explicite indiquant quel objet dépend de quel autre.

Phase 0 : Préparation (Les prérequis fondamentaux)2/3

Définir l’ordre de priorité des “Slices” (Tranches verticales)

Action : Ordonner les flux fonctionnels du plus fondamental au plus dépendant.
Livrable : Une liste ordonnée des tranches à implémenter. (Le document suggère déjà un ordre de 8 slices, de la vitrine Sanity jusqu’à la documentation Starlight, qu’il convient de valider pour votre contexte).

Phase 0 : Préparation (Les prérequis fondamentaux)3/3

Créer le template de “Fiche d’Objet”

Action : Concevoir un modèle standardisé en vous basant sur vos templates existants.
Livrable : Une fiche standardisée par type de ressource. Ce template sera la “source de vérité” absolue pour chaque cycle de développement (DOC → SPEC → CODE → TEST → INTÉG).

Note stratégique : La définition de la “Golden Path”1/3

Toujours dans la catégorie “avant toute chose” (au niveau stratégique), le document insiste sur un point crucial avant de se lancer dans l’implémentation des 8 slices : définir la “Golden Path” (le parcours minimal viable).

Note stratégique : La définition de la “Golden Path”2/3

Avant de coder les fonctionnalités annexes (portfolio, contact, médias, backups), vous devez vous engager à implémenter et stabiliser en priorité absolue :

La page d’accueil (vitrine SSG + Sanity).
Un article de blog (SSG + Sanity + Portable Text).
La recherche Pagefind (indexant au moins ces deux pages).
Le mode Preview (pour les contributeurs).
Le webhook de rebuild (déclenchement automatique du build).

Note stratégique : La définition de la “Golden Path”3/3

En résumé : Votre toute première to-do liste consiste à produire la matrice de dépendances, l’ordonnancement des slices, le template de fiche d’objet, et à valider le périmètre de la Golden Path. Une fois ces 4 livrables produits, vous pourrez commencer le cycle quotidien (DOC → SPEC → CODE…).