Repository navigation
docs: la documentation Typst complète du projet, et l'hébergement permanent (#217) - #218
Merged
Merged
Conversation
Premier lot de `Docs/documentation.typ` : le thème, la page de garde, la table des matières, et les sections 1 à 5 rédigées. Les sections 6 à 8 sont posées en squelette — leurs titres fixent le plan et résolvent les renvois croisés des sections précédentes, leur corps arrive au lot suivant. Le thème importe sa palette de `design/composants.typ` et n'écrit aucun hex : une retouche de `frontend/src/style.css` remonte jusqu'au PDF. Corps inversé pour l'impression, `corail` réservé aux filets et aux étiquettes. Contient 4 des 11 diagrammes (trois axes d'une Race, machine d'état, pipeline d'assets, chaîne d'intégration — plus le handshake d'identité en séquence), les 18 placeholders de capture avec leur légende, et les 12 PNG de `design/out/` embarqués. Trois écarts avec l'énoncé de l'issue, tranchés en faveur du code : le protocole porte 29 messages et non 25 (20 ClientEvent + 9 ServerEvent), une Race a cinq états terminaux et non quatre (`race-state.ts`), et les décomptes de lignes de l'issue étaient surestimés. La compilation exige `--root .` : le document importe hors de `Docs/`. `logo()` de `design/composants.typ` ciblait la seule famille « JetBrainsMono NF » et retombait sur la sérif par défaut là où elle n'est pas installée — le wordmark cessait alors d'être en chasse fixe. Passé en pile de repli, celle que `--font-mono` nomme déjà dans le CSS. `Docs/onboarding.*` n'est pas encore supprimé et le README pas encore modifié : c'est le lot final.
DireDoch
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Premier lot de la documentation Typst (#217), à mi-parcours pour revue.
Ce qui est livré
Docs/documentation.typ→Docs/documentation.pdf(26 pages) :design/out/embarqués.typst compile --root . Docs/documentation.typ Docs/documentation.pdf--root .est exigé : le document importedesign/composants.typetdesign/out/, hors du dossierDocs/.Écarts avec l’énoncé de l’issue, tranchés en faveur du code
ClientEvent+ 9ServerEvent(ws/protocol.rs)finished/abandoned/failed/burned/outpaced(core/race-state.ts:35)design/composants.typUne ligne :
logo()ciblait la seule famille « JetBrainsMono NF » et retombait sur la sérif par défaut là où elle n’est pas installée — le wordmark cessait d’être en chasse fixe, c’est-à-dire cessait d’être celui du jeu. Passé en pile de repli, celle que--font-mononomme déjà dansstyle.css. Les PNG committés sont inchangés si la régénération se fait sur une machine qui a la NF.À trancher
Les polices
Fira Sans,JetBrainsMono NF,Noto Sans,Hackne sont pas installées sur la machine de dev. Le document prendSegoe UI+Consolas— les replis questyle.cssnomme lui-même. Les vraiesInter/JetBrains Monosont dansfrontend/public/fontsmais en.woff2, format que Typst ne charge pas ; les convertir en.ttfet les committer donnerait les polices exactes du jeu.Hors de ce lot
Sections 6 à 8, les 6 diagrammes restants, la suppression de
Docs/onboarding.*, le renvoi depuis leREADME, et le commentaire d’issue listant les captures à prendre.L’issue #217 reste ouverte : elle porte
needs-design-approval, seul le développeur la ferme après validation visuelle.