Notes
Cette page est générée depuis docs/guide.fr.md · Modifier cette page sur GitLab
Les post-it et l'onglet bloc-notes du quotidien, dans l'outil — donc ancrés à ce qu'on y suit (merge requests, tickets) et dans la sauvegarde. Quatre sous-onglets : Aujourd'hui (le brief), Todos, Pages, Période (le rattrapage d'une fenêtre de dates). Rien ne part vers l'IA ni vers une forge sans un geste explicite : le brief, les todos et les pages vivent dans la base locale et ne consomment aucun token ; Période interroge la forge et les clones, et ne dépense de l'IA que si tu lances une review.
Aujourd'hui — le brief du matin
Des sections ordonnées « action d'abord » : ce qui réclame un geste avant ce qui informe. Chacune est masquée quand elle est vide — un écran qui affiche sept titres dont six sous-titrés « rien » apprend qu'il ne s'est rien passé, ce qui n'était pas la question. Chaque ligne mène à son objet en un clic.
- Rappels — les échéances échues et celles du jour, avec la case « fait » et les boutons de report sur place : c'est tout l'intérêt d'un brief, agir sans changer d'écran.
- Todos du jour — les priorités hautes sans date et les échéances d'aujourd'hui. Les hautes sans date sont là parce que « important mais sans échéance » est exactement ce qui se perd : rien ne le remonte jamais tout seul. Une todo déjà listée en Rappels n'y réapparaît pas.
- Sessions en attente de réponse — les sessions où l'IA a posé une question. Ce sont les plus coûteuses à oublier : la session est bloquée, la file est libre, et rien ne repartira sans toi. 4 bis. Sessions de dev en attente — trois nombres, un seul oubli : le travail est fait, il ne manque qu'un geste. Une session jamais lancée ne produira rien ; un projet commité mais pas poussé n'existe pour personne ; une branche poussée sans merge request ne sera jamais relue. Des nombres et non des listes — le détail vit dans Dev IA, et à trois lignes de plus le brief cesserait d'être un brief. Une branche qui a déjà une MR ouverte (même créée ailleurs) ne compte pas : proposer d'en ouvrir une seconde serait pire que de se taire.
- Vérifications en échec — le dernier verdict rouge par lot ou par MR. Les verdicts périmés en sont écartés : la branche a bougé, le verdict porte sur du code qui n'est plus là, et l'afficher enverrait corriger un problème peut-être déjà corrigé. 4 ter. Remarques jamais envoyées — les commentaires inline rédigés dans le viewer et restés là. C'est la perte de travail la plus silencieuse de l'outil : on écrit trois remarques, on referme pour aller voir autre chose, et la merge request se merge sans elles. Les plus anciennes d'abord — c'est l'ancienneté qui inquiète, pas le nombre —, et le bouton rouvre le viewer, là où elles s'envoient. 4 quater. Suivis jamais envoyés — même famille, autre écran : une correction rédigée pendant que la session tournait, puis oubliée. Ceux qui partent tout seuls à la fin (« automatiquement ») sont dits comme tels : ils n'attendent personne. 4 quinquies. Git en suspens — un merge résolu à moitié la veille au soir, et les opérations Git en échec des dernières 24 h (une branche protégée qu'on a tenté de supprimer, un tag refusé). Un merge à moitié fini ne vit que dans un dossier de travail : aucun badge ne le rappelle, et on le retrouve trois jours plus tard en cherchant autre chose. Reprendre rouvre l'écran de merge, Voir l'historique ouvre le journal Git filtré sur le projet et sur les seuls échecs. 4 sexies. Conteneurs tombés — ce que la veille de fond a relevé au dernier tour. Un conteneur tombé est
restarting,dead, ou sorti en erreur : un arrêt demandé (docker stop) n'est pas une panne, et le peindre en rouge ferait sonner l'alarme tous les jours. La section est datée — c'est un relevé, pas un direct — et absente tant que Docker n'a pas été regardé, plutôt que d'annoncer « 0 conteneur tombé » sans avoir rien regardé. - MR à traiter — celles arrivées depuis hier, pas la file entière (elle a son onglet et son badge).
- MR dormantes — reviewées il y a plus de N jours (réglable, 5 par défaut) et toujours ouvertes : le travail est fait, la décision manque. 6 bis. MR qui se croisent — une ligne par paire de merge requests ouvertes du même dépôt qui modifient les mêmes fichiers :
!214 ↔ !219 · groupe/tarification · 3 fichiers · depuis 2 j, les paires les plus anciennes d'abord. Clic : Reviews filtré sur le dépôt, les deux merge requests en tête. La croix écarte une paire, pas un dépôt : une paire nouvelle reparaît. 6 ter. MR sans test — une ligne par merge request ouverte qui porte le badge accentué :!214 — Refactor TVA · groupe/tarification · 14 fichiers · 0 test · ouverte il y a 2 j, les plus anciennes d'abord. Clic : la merge request dans Reviews. La croix écarte cette merge request sur ce commit : un relevé sur un nouveau commit la fait reparaître. 6 quater. MR qui ajoutent des dépendances — une ligne par merge request ouverte dont un manifeste gagne une dépendance directe :!214 — Refactor TVA · groupe/tarification · +2 dépendances · 1 majeur · ouverte il y a 2 j, les plus anciennes d'abord, huit au plus. Clic et croix : comme les MR sans test. - Activité depuis hier — une ligne, trois nombres. Volontairement pauvre : c'est du contexte, pas une tâche ; le détail vit dans Stats.
Chercher dans le journal d'un job. Un run de vérification déverse deux mille lignes : le champ de la barre du panneau masque celles qui ne contiennent pas ce qu'on cherche, et la case Erreurs ne garde que les lignes rouges. Rien n'est coupé — le compte dit ce qui est caché, et décocher ramène tout. Un double-clic sur une ligne qui parle d'une merge request ouvre son rapport.
Écarter une ligne qui revient tous les matins. Le brief recalcule tout à chaque ouverture : un fait qui reste vrai reparaît indéfiniment, même traité ailleurs — une vérification rouge dont on a déjà fait le tour finit par apprendre à ne plus lire la section. Une croix au survol de la ligne l'écarte : elle disparaît du brief et n'y revient plus. Vaut pour les vérifications, les sessions en attente et les MR.
⚠ On écarte un constat, pas un sujet. La croix retient l'objet vu — ce verdict-ci, cette MR-là : une nouvelle vérification du même lot porte un autre identifiant et reparaîtra. C'est voulu — sinon une vraie régression resterait invisible pour toujours. Rien n'est supprimé (le verdict garde sa page dans Reviews), le brief affiche en pied combien de lignes il cache, et Tout réafficher les ramène d'un bouton. Une ligne écartée fait remonter la suivante : les sections plafonnent à huit, et une section qui rétrécit à chaque geste finirait par mentir sur ce qu'il reste à faire.
Tout est calculé en SQL, sans IA et sans réseau : le brief s'affiche instantanément, avant le premier café, et ne coûte rien. Un résumé rédigé par un agent était tentant ; il aurait fait payer un appel chaque matin pour reformuler des faits qui se lisent déjà.
Atterrissage. À la première ouverture de la journée, l'application s'ouvre ici plutôt que sur le dernier onglet consulté. Une fois par jour calendaire, jamais deux — sinon chaque rechargement ramènerait sur le brief celui qui lisait un rapport. Débrayable dans Réglages → Général.
Todos
Une liste plate, triée par priorité d'abord, puis dans l'ordre que tu lui donnes. Deux questions différentes, chacune garde sa réponse : la priorité dit ce qui presse, ton ordre dit dans quel ordre tu t'y prends à l'intérieur de ce qui presse. « À faire » se réordonne à la souris (poignée à gauche, glisser-déposer) ou au clavier (deux flèches par ligne — glisser n'est ni annonçable ni fiable au clavier et au doigt), et l'ordre est enregistré : un ordre qui ne survit pas au rechargement n'est pas un ordre.
⚠ On ne réordonne qu'à l'intérieur d'une priorité. Emmener une todo dans un autre groupe la ferait revenir aussitôt, et un geste qui n'aboutit pas est pire que pas de geste : les flèches s'éteignent aux frontières de groupe, et le glisser ne les traverse pas. Pour changer de groupe, on change la priorité — c'est un autre geste, et il est explicite. L'échéance, elle, ne trie plus rien ici : elle reste affichée et continue d'alimenter le brief du matin et les rappels. Le jour de la mise à jour, ta liste garde exactement l'ordre qu'elle avait. Les vues Faites et Archivées gardent leur ordre chronologique : on n'arrange pas son tiroir.
- Ajout inline en tête de liste : on tape, Entrée, c'est créé — priorité normale, sans date. Une todo neuve se range en tête, là où on vient de la taper ; la chercher en bas d'une liste de trente serait absurde.
- Statut binaire : à faire / fait. Pas de « en cours » : une todo de poste de travail se coche, elle ne se pilote pas.
- Priorité haute / normale / basse. La normale n'affiche aucune pastille — la baliser serait du bruit.
- Échéance = rappel : une seule date, qui sert des deux côtés. Elle s'affiche en relatif (« demain 9 h », « dans 3 j »), et en rouge seulement si elle est dépassée : une échéance à venir n'est pas une alarme.
- Report en un clic : +1 h ou demain 9 h. « Demain 9 h » veut dire 9 h au cadran, pas « dans 24 heures » — un changement d'heure ne doit pas décaler le rendez-vous.
- Lien optionnel vers une merge request, un ticket ou un dépôt : la ligne devient cliquable. Une todo liée à une merge request affiche l'état de cette MR sous son titre (note, verdict, ouverte depuis combien de temps) : on sait si elle a encore une raison d'exister.
- Une todo liée à un ticket dit ce qu'il est devenu : son statut Jira, et les merge requests qui portent sa clé. Rien n'est demandé au réseau — l'état vient de la surveillance ou de ce que la découverte a rangé.
- Une todo liée à une merge request se coche quand la MR est mergée, avec une note disant ce qui l'a fermée — « Fermée automatiquement : la merge request !201 a été mergée ou fermée ». Rien n'est supprimé et elle se rouvre ; Réglages → Général porte l'interrupteur (« Cocher les todos liées quand leur merge request est mergée ») pour qui préfère fermer à la main.
- Rien n'est supprimé. Une todo faite reste barrée sept jours — on veut voir ce qu'on a fait cette semaine — puis passe dans Archivées, où elle reste consultable. La rouvrir la sort du tiroir. Le bouton Supprimer existe, mais cocher « fait » est le geste normal.
- Trois filtres : À faire · Faites · Archivées.
- Le menu porte le compte : rouge ce qui presse (en retard ou priorité haute), bleu le reste à faire.
Capture rapide — la touche n
Depuis n'importe quel onglet, n ouvre une mini-modale : un champ, Entrée crée la todo, Échap annule. Un lien « + détails » déplie priorité, échéance et note quand c'est utile. Après création, un toast discret — et aucune navigation : on était en train de faire autre chose. Si la capture coûtait plus de deux secondes, on retournerait au post-it. La touche est ignorée quand le curseur est dans un champ de saisie.
Pages
Des pages de notes plates : ni dossiers ni hiérarchie. À gauche la liste (épinglées en tête, puis les plus récemment modifiées, chaque titre en entier, sur plusieurs lignes s'il le faut, la date et le compte de sous-pages dessous) avec une recherche qui porte sur le titre ET le contenu — c'est souvent dans le corps que se trouve le mot cherché. À droite le titre éditable, puis la saisie et l'aperçu Markdown côte à côte (le même rendu que les rapports de review, donc le même échappement).
- Autosauvegarde à la frappe, avec un délai d'une seconde et un indicateur discret « Enregistré ». Enregistrer à chaque caractère ferait une requête par lettre ; n'enregistrer qu'à la fermeture perdrait le travail d'une page restée ouverte.
- Plein écran : un bouton à côté de Rendu / Deux colonnes / Markdown retire la liste des pages et étend l'éditeur à toute la fenêtre — les trois modes restent choisissables pendant la lecture. Échap, ou le même bouton, revient aux deux colonnes.
- Coller une capture (Ctrl+V) dans l'éditeur l'insère au curseur, sur sa propre ligne, et l'aperçu l'affiche aussitôt. L'image part sur le disque (
data/notes/<page>/) et la page ne garde qu'un lien : mettre la capture en base64 dans le contenu gonflerait la ligne de plusieurs mégaoctets, renvoyés en entier à chaque autosauvegarde — c'est-à-dire toutes les secondes pendant qu'on écrit. - Un bloc
`mermaiddevient un diagramme. Ce que le documentaliste dessine se lit comme un schéma, pas comme du texte. La bibliothèque de rendu est posée dans le dépôt (public/vendor/mermaid.min.js, jamais un CDN : rien ne sort de la machine) et n'est chargée qu'au premier diagramme rencontré — une page qui n'en contient pas ne paie pas ses cinq mégaoctets. Les couleurs suivent le thème, et changer de thème refait les diagrammes, dont les couleurs sont cuites dans le SVG. Un diagramme qui ne compile pas garde sa source affichée, avec l'erreur au-dessus : une faute de frappe n'emporte pas la page. - Épingler garde une page en tête de liste.
- Exporter télécharge la page en
.md, au nom slugifié depuis le titre. ⚠ Les captures y sont référencées par leur adresse dans Mergerie : le.mdrelu ailleurs affichera le texte, pas les images. - Supprimer demande confirmation — c'est la seule action irréversible de l'onglet. Les captures de la page partent avec elle, fichiers compris.
Autolink — !214 et PROJ-720 deviennent des liens
Ce qu'on écrit dans une note, ce sont les identifiants du quotidien. Ils deviennent cliquables au rendu (pages, notes de todos) ; le stockage reste du texte brut — on relit ses notes ailleurs, et un .md exporté ne doit pas charrier du HTML.
!214→ la merge request. Un seul dépôt porte ce numéro : lien direct. Plusieurs : lien vers Reviews avec la recherche pré-remplie, qui montre les candidats — on ne devine pas, un lien faux est pire qu'un lien qui demande de choisir. Aucun : le texte reste du texte, pas de lien mort. Sont résolues les merge requests encore ouvertes, plus celles qui ont bougé dans les six derniers mois : au-delà, une MR fermée n'est plus une référence qu'on écrit dans une note, et relire toute la table à chaque ouverture de l'onglet coûterait cher pour trois références.PROJ-720→ le ticket, si Jira est configuré.- Une URL collée devient cliquable (nouvel onglet).
http/httpsseulement : une note est du texte qu'on colle sans le relire, et un lien fabriqué n'a pas à pouvoir exécuter quoi que ce soit —javascript:et consorts restent du texte. La ponctuation qui ferme la phrase reste dehors, et une référence contenue dans une URL n'est pas re-transformée (coller un lien Jira ne fabrique pas un second lien à l'intérieur du premier). - Rien n'est transformé dans un bloc de code :
!42dans un extrait de shell est du code. - Le contenu est échappé d'abord, l'autolink s'applique après et n'injecte que des balises qu'il fabrique lui-même. Aucun fragment d'une note ne peut devenir du balisage.
Et dans l'autre sens : « 1 note en parle ». Le lien n'existait que d'un côté — la note menait à la merge request, et la merge request ignorait qu'on avait écrit trois paragraphes sur elle lundi. Le rapport d'une review et la fiche d'un ticket Jira listent donc maintenant les notes qui les citent, avec l'extrait pris autour de la citation (le titre d'une page ne dit presque jamais ce qui a été dit de cet objet-là). La règle de « citer » est celle du rendu, pas une seconde recherche : a!=218 est une comparaison, pas une citation, et une liste de liens entrants qui contient des faux ne sert à rien.
« Ajouter aux todos », depuis une MR ou un ticket
Un bouton sur le détail d'une merge request et sur celui d'un ticket Jira ouvre la capture rapide pré-remplie : titre proposé (Suivre !214 — <titre>), lien posé, priorité normale, sans date — tout reste éditable. Si une todo ouverte suit déjà cet objet, le bouton devient « Voir la todo » : créer un doublon silencieux serait la façon la plus sûre de rendre la liste inutilisable en une semaine.
Et depuis quatre autres endroits. « Rebaser cette branche avant lundi », « ce vérificateur est rouge depuis mardi », « ce build casse une fois sur trois », « ce conteneur retombe toutes les nuits » sont exactement ce qu'on se note — et rien ne les portait : le bouton n'existait que sur une merge request et un ticket, alors on écrivait du texte libre, sans lien pour y retourner. Le même bouton est donc posé sur la ligne d'une branche (explorateur), le rapport d'une vérification, la ligne d'un build Jenkins et la ligne d'un conteneur. La todo garde de quoi y revenir : l'explorateur s'ouvre sur le dépôt de la branche, le rapport de vérification se rouvre, la fiche du job Jenkins aussi.
Rappels
Le canal est celui des notifications bureau existantes, avec sa propre catégorie « Rappels » (activée par défaut, Réglages → Notifications).
- Une échéance atteinte donne une notification, une seule fois — et repousser la fait re-sonner : sans cela, snoozer un rappel déjà notifié le rendrait définitivement muet.
- La notification est marquée comme envoyée après affichage, pas à la lecture de la liste : une notification qui échoue (permission refusée, onglet fermé entre-temps) ne doit pas consommer l'unique occasion de prévenir.
- Rattrapage au démarrage : si plusieurs rappels sont en retard au chargement, ils donnent une seule notification groupée (« 3 rappels en attente ») — dix pop-ups au démarrage se ferment sans être lues.
- ⚠ Limite à connaître : les rappels partent du navigateur. Il faut donc que l'onglet Mergerie soit ouvert quelque part. Un rappel dû pendant que tout est fermé n'est pas perdu — il part au prochain chargement, dans le rattrapage.
- Les boutons de report sont dans l'interface, pas dans la notification : des actions de notification exigeraient un service worker, hors périmètre.
Les notes, les todos et leur historique vivent dans la base du dossier de données : ils sont donc couverts par la sauvegarde (Réglages → Général), au même titre que les rapports de review.
Période — rattraper ce qui s'est passé
« Je pars dix jours. À mon retour, qu'est-ce qui a bougé sur les dépôts ? » Pendant l'absence, le poste est éteint : la découverte n'a pas tourné, et ce qui a été ouvert et mergé entre-temps n'apparaît nulle part. Période reconstruit donc une fenêtre de dates depuis la forge et le clone de chaque dépôt, pas depuis ce que Mergerie a vu. Deux dates, Construire, et un job interroge tout ; l'écran se remplit à sa fin. La fenêtre vaut aussi pour relire un sprint, préparer une rétro ou reprendre un dépôt qu'on n'a pas suivi — c'est une période, pas un congé.
Les sections, dans l'ordre des gestes à faire :
- Pushs directs sur des branches surveillées — en rouge, en tête : des commits entrés dans
main(ou une branche protégée) sans merge request. Personne ne les a relus, c'est l'information la plus précieuse de l'écran. Regroupés par push (commits consécutifs du même auteur), étiquetés revert, merge manuel ou bot (les bots sont masqués d'office). Un commit passé par une merge request n'y est jamais, quelle que soit la stratégie de merge — merge commit, squash, fast-forward, ou le rebase-merge de GitHub qui réécrit les SHA (reconnu par le contenu du patch). Ce que la forge n'a pas pu confirmer est marqué non vérifié, en orange : un doute affiché vaut mieux qu'un collègue accusé à tort. Gestes : Voir le diff (l'explorateur plein écran de ⛶ Ouvrir le code, le même que pour une merge request ou une session : toute l'arborescence du commit, les fichiers touchés marqués, chaque fichier entier avec ses changements en place, et à gauche l'auteur et la liste des commits du push), Relire ce push (une session d'exploration pré-remplie, l'IA relit les commits comme une review), Vérifier cette branche, Ajouter aux todos, Session de correction. - Merge requests mergées — chacune dit si elle a été reviewée avant le merge (par toi, ou par un collègue sur la base partagée) ou jamais. Reviewer a posteriori relit la merge request telle qu'elle a été mergée, par ses SHA : la base au moment de la MR et sa tête, ramenée par la ref que la forge conserve même branche supprimée — un diff à trois points serait vide une fois la tête dans la cible. Le prompt dit à l'IA que la MR est déjà mergée et lui demande de classer en à corriger maintenant / à surveiller / RAS ; rien n'est publié sur la forge tout seul. Reviewer les N non relues lance le lot, en annonçant le coût.
- Arrivées, toujours ouvertes — elles sont dans la file de Reviews ; ici on les signale seulement.
- Fermées sans merge, connues avant et actives pendant (repliée : un changement d'étiquette suffit à bouger une MR), tags, branches supprimées et pipelines — un pipeline rouge sur une branche surveillée à la date du retour ouvre la section de lui-même.
- Fait par l'équipe dans Mergerie — avec un dépôt de données partagé : les reviews, sessions, todos et pages écrites par quelqu'un d'autre pendant la fenêtre, et ce que la synchro a fait entrer depuis le début de la fenêtre, quelle que soit la date écrite par le collègue (marqué arrivé par la synchro : ce signal ne dépend d'aucune horloge que la tienne). Une MR mergée et reviewée par un collègue n'apparaît qu'une fois, dans « mergées », avec la mention. Dans Reviews, une pastille nouveau pour toi marque les cartes dont le rapport est arrivé par la synchro et n'a jamais été ouvert ici — utile tous les jours, pas seulement au retour.
- Jira (si configuré) — les tickets qui ont changé d'état ou t'ont été affectés pendant la fenêtre : les tiens, les surveillés, ceux des merge requests de la période. Un Jira qui tombe rend la section partielle, jamais la période.
- Pendant ce temps, Mergerie a… — si le poste est resté allumé : les passes des agents planifiés (une ligne par agent, avec ses erreurs) et les vérifications lancées dans la fenêtre, le rapport à un clic.
Sur GitLab, les pushs directs sont regroupés exactement comme la forge les a vus (ses événements de push) ; GitHub ne les expose pas, l'heuristique (même auteur, moins de trente minutes) y reste. Reviewer les N non relues ordonne le lot par risque décroissant (fichiers sensibles, puis taille), bots exclus.
Résumer la période (≈ 1 appel IA) — l'option, jamais par défaut : dix lignes par dépôt sur ce qui change pour quelqu'un qui revient, en citant les !iid, rendues en tête comme un rapport d'agent et balisées texte d'une IA, non fiable. Utile au-delà de trente merge requests ; en dessous, la liste se lit plus vite.
Chaque ligne porte vu : l'écran est une liste qu'on vide. L'état survit à un rechargement et à Recalculer ; le compteur du sous-onglet est le nombre de lignes non vues. Un dépôt dont la forge est tombée, ou dont un plafond a été atteint, est partiel et le dit sur sa section — jamais exhaustif en apparence.
Au passage, la base est réparée : les merge requests mergées pendant l'absence sont écrites avec leurs dates et leurs SHA, la session qui avait ouvert la branche est liée (« Créer la MR » ne réapparaît pas sur une branche déjà mergée), les todos liées sont cochées, et le journal du brief est daté au merge, pas au retour.
La bannière du brief. Quand ce poste n'a pas vu un geste (clavier, souris) depuis plus de N jours (Réglages → Général, 3 par défaut — un week-end n'est pas une absence), Aujourd'hui ouvre sur « Tu n'as pas ouvert Mergerie depuis 12 jours — voir ce qui s'est passé » : un clic construit la période de l'absence. La présence se mesure sur un geste réel, pas sur un onglet resté ouvert : un poste de bureau allumé pendant tout le congé n'est pas « présent ». Et le premier geste du retour ne fait pas tomber la bannière : l'absence est figée au moment où elle se termine, jusqu'à ce que la période soit ouverte ou la bannière écartée d'une croix. Je pars, dans la barre de Période, pose le début de l'absence à la minute : un passage furtif au bureau ne le décale plus, et la fenêtre proposée au retour est exacte ; Annuler l'oublie.
Réglages. Général : le seuil de la bannière, masquer les bots, surveiller les branches protégées en plus de la branche par défaut (une décision d'équipe : c'est la définition de « entré sans relecture »). Dépôts : une liste de branches surveillées propre à un dépôt, dans sa ligne d'édition.