Esc
 Naviguer  Ouvrir Esc Fermer
Aller au contenu

15.2 — Outils

🎯 Objectif : choisir un outil de gestion de tickets adapté au contexte, écrire des tickets que les devs peuvent commencer sans rien demander, et tenir la base de connaissances vivante.

À l'issue de cet axe, tu sauras :

  • Comparer les outils de gestion de tickets 2026 (Linear, Jira, GitHub, Trello, Notion)
  • Écrire un ticket qui démarre tout seul (contexte, AC, maquette, edge cases)
  • Définir DoR et DoD adaptés à ton équipe
  • Choisir un outil de doc qui survive à 2 ans (Notion, Confluence, MDX en repo)
  • Mettre en place une nomenclature de labels et de types qui ne dérive pas

Confirmé 11 min prérequis : aucun prérequis technique

OutilForceFaiblessePour qui
LinearUX rapide, raccourcis clavier, opinions fortes (cycles), GitHub-tightMoins customisable, pricing par seatStartup tech 5-100 devs
JiraCustomisable à l’extrême, écosystème énormeLourd, lent, complexité combinatoireGrandes orgs, contextes audités
GitHub ProjectsIntégré au repo, gratuitPeu structuré, pas idéal en multi-repoOpen source, side-projects
TrelloSimple, low-frictionPas de hiérarchie, scale malPetites équipes, projets simples
NotionTout-en-un (doc + DB + tickets)Pas un vrai tracker, lent à grande échellePetites équipes < 30, doc-centric
ClickUp / AsanaPolyvalents, customisablesUX moins fine que LinearHors-tech / mixed teams
PlaneOSS, Linear-likePlus jeune, moins de featuresSelf-host, OSS-friendly
HeightAuto-org IAPeu mature 2026Early adopters

En 2026 dans la tech, Linear est le défaut sur les startups. Jira reste le défaut sur les grandes orgs (souvent imposé). GitHub Projects monte sur les petits projets et l’open source. Notion s’utilise comme doc + roadmap macro, rarement comme tracker primaire.


Concept LinearÉquivalent Jira / Scrum
IssueTicket / story
ProjectEpic
CycleSprint
InitiativeProgramme / theme
TriageInbox de tickets non priorisés
RoadmapPlanning macro
Backlog → Todo → In Progress → In Review → Done
  • Raccourcis clavier partout : C pour créer, M pour move, Cmd+K pour tout.
  • Cycles automatiques (sprint hebdo / bi-mensuel).
  • Liens GitHub bidirectionnels : PR ouverte → ticket In Review automatique.
  • Slack intégration native, threads par issue.
  • API GraphQL solide pour automatisations.
  • Pricing par seat ~10 $/mois — rapidement coûteux.
  • Customization limitée (par design).
  • Pas idéal pour des workflows non-tech (RH, finance).

Jira reste dominant dans les grandes orgs (banques, gouvernements, audit ISO). Trois raisons à connaître :

  1. Conformité : Jira a des certifs (ISO 27001, FedRAMP, HIPAA) que les concurrents n’ont pas.
  2. Customisation profonde : workflow, champs, automations, sub-tasks, components.
  3. Plugins (Marketplace Atlassian).
  • Sub-task de sub-task de sub-task → personne ne sait ce qu’il fait.
  • 40 champs custom obligatoires par ticket → personne ne les remplit.
  • 20 statuts au lieu de 4-5 → tableau illisible.
  • Workflow différent par projet → impossibilité de comparer.

Si on te donne du Jira en arrivant, négocie un audit du workflow avant de prétendre le suivre. La plupart des Jira d’entreprise sont broken by design par accumulation.


GitHub Repo
├── Issues
├── Pull Requests
└── Project (board personnalisé)
├── Status (ToDo, In progress, Done)
├── Iteration (cycles)
├── Priority
└── Custom fields

Avantages :

  • Gratuit illimité.
  • Tickets et PR au même endroit que le code.
  • Multi-repo possible.
  • Automations natives (PR mergée → status Done).

Limites :

  • Reporting basique.
  • Pas idéal pour > 10 personnes en équipe pure produit.
  • Pas de roadmap macro propre.

Idéal pour : open source, side-project, petite équipe full-tech.


Un ticket bien écrit est un ticket que le dev peut démarrer sans interrompre personne.

# Titre court et actionnable
## Contexte
Pourquoi on fait ça. À quel besoin ça répond.
Lien vers ticket parent / discussion / RFC si applicable.
## Critères d'acceptation
- [ ] AC 1 — testable
- [ ] AC 2 — testable
- [ ] AC 3 — testable
## Spec technique (si pertinent)
- API : `POST /api/orders` body `{...}` réponse `{...}`
- Schéma DB modifié : ajout colonne `orders.status` enum
- Maquettes : [lien Figma]
## Edge cases / scénarios à couvrir
- Utilisateur non connecté
- Quantité 0
- Stock insuffisant
## Out of scope (explicite !)
- Pas de notif push
- Pas d'export PDF (V2)
## Notes
Lien vers tickets liés, doc, prior art.
  • Titre actionnable (« Ajouter X » > « Problème avec Y »)
  • Contexte clair (pourquoi)
  • AC testables (évite « bien marcher »)
  • Maquettes UI / contrat API si nécessaire
  • Edge cases listés
  • Out of scope explicite
  • Estimation rough (T-shirt ou points)
  • Pas de blockers ouvertes
  • Owner / champion dans l’équipe
SymptômeRéaction
Titre : « Bug »Refuser → demander plus de précision
Description : « cf Slack thread »Refuser → résumer dans le ticket
AC absenteRefuser → trop de risque d’interprétation
Estimation à 1 point pour un truc grosRe-discuter
Ticket à 30 ACDécouper en sous-tickets
5 « urgent » par jourRenégocier la définition d’urgent

Voir 15.1, mais à instancier dans l’outil :

# Definition of Ready (Linear / Jira)
Un ticket peut entrer en cycle si :
- [ ] Description complète (template suivi)
- [ ] AC testables
- [ ] Estimation faite
- [ ] Maquettes / contrat API si nécessaire
- [ ] Pas de dépendance bloquante
# Definition of Done
Un ticket est Done quand :
- [ ] PR mergée sur main
- [ ] Tests automatisés passent
- [ ] Code review validée
- [ ] Documentation à jour (README, OpenAPI, ADR si pertinent)
- [ ] Déployé en staging
- [ ] AC cochés par PO
- [ ] Métriques (perf, erreurs) inchangées ou améliorées

Affiche-les dans l’outil (Confluence Page épinglée, Linear template, Notion page principale). Sinon ils existent en théorie, pas en pratique.


Limiter à 3-5 catégories de labels :

CatégorieExemples
Typebug · feature · chore · spike · doc
PriorityP0 · P1 · P2 · P3
Domainfrontend · backend · infra · design
Status spécialneeds-design · needs-review · blocked

Anti-patterns labels :

  • 40 labels créés par 8 personnes différentes → personne ne sait lesquels utiliser.
  • Labels personnels (alice-todo).
  • Labels redondants avec le statut Linear / Jira.
  • Pas de doc des labels.

Une fois par trimestre, purge les labels inutilisés. Sinon ils s’empilent.


StackForceFaiblesse
NotionUX excellente, DB inline, partage facileLent à scale, lock-in, pas idéal pour la doc technique liée au code
ConfluenceStandard entreprise, lié à JiraUX vieillissante, pages qui pourrissent
MDX dans le repo (Docusaurus, Starlight, MkDocs)À côté du code, versionné, code review, gratuitPas de DB inline, plus de friction d’édition pour non-tech
OutlineOSS Notion-likeMoins de features
Slack canal pinned0 frictionCatastrophique en doc — non recherchable, pas structurée
  • Doc applicative & technique (architecture, ADR, runbooks, conventions) → MDX dans le repo, à côté du code, mise à jour en PR.
  • Doc produit / process / RH → Notion (ou Confluence si c’est l’orga).
  • Slack sert pour les conversations, pas la documentation. Tout point durable doit migrer vers la doc dans la journée.

Une doc non maintenue est pire qu’absente : elle ment.

Stratégies anti-pourriture :

  • Owner par page (qui maintient ?).
  • Date de dernière revue dans la page.
  • Auto-flag des pages > 6 mois sans modif.
  • Lien depuis le code (« voir docs/architecture.md ») → la doc remonte au radar quand le code change.
  • Sunset explicite : page archivée plutôt que laissée à l’abandon.

  • PR mergée → status In Review puis Done.
  • Branch créée → assigne le ticket à son auteur.
  • Tag bug + P0 → notif Slack #incidents.
  • Cycle qui finit → résumé auto en Slack.
  • Issue créée avec label bug → ajout automatique au project.
  • PR draft → exclure du board.
  • PR ouverte > 5 jours → bot ping l’auteur.
  • Daily standup : un bot demande à 9h30 « Qu’as-tu fait hier ? Aujourd’hui ? Blocage ? » — async > synchrone.
  • Reminder rétro la veille avec board pré-rempli.

« Adapte l’outil à l’équipe, pas l’inverse. »

Aucun outil ne va sauver une équipe dysfonctionnelle. Et les meilleures équipes peuvent fonctionner avec un Trello + Slack si elles ont la discipline.

Quand changer d’outil :

  • Friction quotidienne mesurable (ralentit la prise de tickets).
  • Limites techniques (multi-repo, scale).
  • Coût disproportionné.
  • Demande forte de l’équipe (pas du management).

Pas un changement par an. Stabilise.


On t'arrive sur un projet Jira avec 20 statuts, 40 champs custom obligatoires et 3 niveaux de sub-tasks. Que faire ?
Un ticket arrive : « Bug : ça ne marche pas — voir Slack ». Tu es dev, ça t'est assigné. Que faire ?
Vous êtes une équipe de 5 devs sur un side-project open source. Quel outil tickets choisir ?
Vous avez 80 pages Confluence créées sur 3 ans. La moitié sont obsolètes. Stratégie ?


Suite : 15.3 — Communication & collaboration — RFC, ADR, post-mortem, feedback de revue.