Importer une base de code existante dans Taiga
Examinez ce que Taiga déduit du dépôt. Distinguez comportement actuel et comportement souhaité, puis choisissez la réponse adaptée à un document inexact.
Publié par TaigaNotre méthode de rédaction
Ce que vous apprendrez
- Préparer un dépôt lié pour un produit importé.
- Distinguer un défaut de code, une instruction permanente et une erreur d’analyse.
- Examiner les initiatives proposées au regard des lacunes réelles et des capacités existantes.
Partir du système existant
Un service fictif de demandes d’équipement existe déjà. L’équipe souhaite le maintenir avec Taiga tout en conservant ses intégrations fonctionnelles.
Choisissez Import codebase à la création du produit. Liez le dépôt et lancez l’analyse. Ce parcours utilise l’analyse du dépôt à la place de la conversation d’un nouveau produit. Un produit créé de zéro n’ajoute pas ce parcours d’import plus tard.
Confirmez l’accès au dépôt et la branche sur laquelle Taiga doit travailler. Ajoutez les contraintes permanentes au niveau de contexte approprié. Dans cet exemple, précisez que l’intégration existante d’identité des salariés doit rester utilisée.
Examiner d’abord la spécification déduite
Taiga déduit les documents produit du code et inclut des références au dépôt. Elles aident à vérifier l’interprétation. Elles n’établissent pas l’intention métier derrière chaque pratique existante.
Examinez trois éléments de la spécification :
- Objectif : l’objectif décrit correspond-il à la raison d’être du service ?
- Contraintes : quelles pratiques sont des exigences délibérées ?
- Défauts connus : quels comportements actuels doivent changer ?
Le service d’équipement contient un ancien module d’autorisation. Un document peut signaler correctement son utilisation. Cela ne signifie pas que l’équipe doit l’étendre.
Ouvrez un fichier cité et comparez le comportement pertinent à l’affirmation. Consignez les limites des preuves disponibles, comme une configuration ou un comportement d’exploitation situé hors du dépôt.
Choisir la bonne correction
| Situation | Réponse |
|---|---|
| Le document décrit correctement un code indésirable | Planifier et réaliser la modification du code |
| L’équipe dispose d’une règle permanente pour les travaux futurs | Placer la règle dans les instructions produit |
| L’analyse a mal interprété le dépôt | Utiliser Refresh this document et examiner le résultat |
Les documents importés suivent le code. Ne les traitez pas comme des descriptions manuelles d’un futur système. L’actualisation d’un document recalcule aussi les documents dont il dépend. Actualiser un document situé plus loin dans la chaîne peut donc demander davantage de travail.
Pour l’ancien module, une instruction pourrait dire : « N’ajoutez pas de nouveaux appelants à l’ancien module d’autorisation. Utilisez l’interface de remplacement approuvée pour les nouveaux travaux. » Vérifiez que cette interface existe et indiquez son emplacement réel dans le dépôt.
Évaluer les premières initiatives
Le parcours d’import exécute aussi des analyses du dépôt, une évaluation par rapport aux politiques publiées et une première planification des initiatives. Une étape sans son prérequis peut être ignorée avec une explication. La planification utilise les résultats et l’évaluation des politiques disponibles.
Examinez les lacunes proposées au regard du dépôt. Les premières initiatives traitent les capacités manquantes, les fondations ou les problèmes pertinents de dépendances non résolus. Ce n’est pas une liste de nouvelles fonctionnalités que personne n’a demandées.
Conservez une capacité existante utile. Rejetez ou corrigez une proposition qui la reconstruirait inutilement. Ajoutez une initiative distincte pour une nouvelle exigence métier.
Préserver un point de départ fondé sur les preuves
Terminez Discovery et examinez les propositions d’initiatives. Confirmez l’environnement et les responsabilités de livraison avant la planification détaillée. Gardez les imports, les modifications du code et les instructions produit cohérents à mesure que le travail avance.
Le résultat est un point de départ compris et un backlog modifiable. Ce n’est pas une déclaration que tous les comportements existants sont corrects. Poursuivez avec la planification des initiatives.
Faire l’exercice
Un service fictif importé utilise un ancien module d’autorisation. Son remplacement est déjà prévu. Rédigez une instruction produit qui empêche de nouvelles dépendances à ce module. Identifiez ensuite une référence au dépôt à examiner dans la spécification importée.
Télécharger la fiche d’exercice (Markdown)Vérifier votre compréhension
Sources et lectures complémentaires
Lectures Taiga sur le sujet
Désactiver cette option supprime toute la progression enregistrée dans ce navigateur.
Votre progression reste dans ce navigateur. Sans compte ni suivi.