Leerpad 07Les 2 / 8

Breng een bestaande codebase naar Taiga

Review wat Taiga uit een repository afleidt. Scheid huidig gedrag van bedoeld gedrag en kies de juiste reactie op een onjuist document.

Praktijk11 minGereviewd

Gepubliceerd door Hoe we schrijven

Wat u leert

  • Bereid een gekoppelde repository voor op een geïmporteerd product.
  • Onderscheid een codedefect, een vaste instructie en een analysefout.
  • Review voorgestelde initiatieven aan de hand van echte hiaten en bestaande mogelijkheden.

Begin bij het systeem dat u hebt

Er bestaat al een fictieve service voor materiaalaanvragen. Het team wil die met Taiga onderhouden en de werkende integraties behouden.

Kies Import codebase bij het aanmaken van het product. Koppel de repository en start de analyse. Deze route gebruikt repositoryanalyse in plaats van het gesprek voor een nieuw product. Een product dat vanaf nul is aangemaakt, krijgt deze importroute niet later alsnog.

Bevestig repositorytoegang en de branch waarop Taiga moet werken. Voeg vaste voorwaarden toe op het passende contextniveau. Vermeld voor dit voorbeeld dat de bestaande identiteitsintegratie voor medewerkers in gebruik moet blijven.

Review eerst de afgeleide specificatie

Taiga leidt productdocumenten af uit de code en neemt repositoryverwijzingen op. Die verwijzingen helpen de interpretatie te controleren. Ze stellen niet de bedrijfsintentie achter elk bestaand patroon vast.

Controleer drie zaken in de specificatie:

  • Doel: Komt het beschreven doel overeen met de reden waarom de service bestaat?
  • Voorwaarden: Welke patronen zijn bewuste eisen?
  • Bekende defecten: Welk huidig gedrag moet veranderen?

De materiaalservice bevat een verouderde autorisatiemodule. Een document kan het gebruik ervan correct weergeven. Dat betekent niet dat het team de module moet uitbreiden.

Open een aangehaald bestand en vergelijk het relevante gedrag met de claim. Leg beperkingen van het beschikbare bewijs vast, zoals configuratie of operationeel gedrag buiten de repository.

Kies de juiste correctie

SituatieReactie
Het document beschrijft ongewenste code correctPlan en bouw de codewijziging
Het team heeft een vaste regel voor toekomstig werkPlaats de regel in productinstructies
De analyse heeft de repository verkeerd geïnterpreteerdGebruik Refresh this document en bekijk het resultaat

Geïmporteerde documenten volgen de code. Behandel ze niet als handmatig onderhouden beschrijvingen van een toekomstig systeem. Een document verversen leidt ook de documenten waarvan het afhankelijk is opnieuw af. Het verversen van een later document kan daarom meer werk vereisen.

Voor de verouderde module kan een instructie luiden: ‘Voeg geen nieuwe aanroepers toe aan de verouderde autorisatiemodule. Gebruik voor nieuw werk de goedgekeurde vervangende interface.’ Controleer of die interface bestaat en benoem de werkelijke locatie in de repository.

Beoordeel de eerste initiatieven

De importworkflow voert ook repositoryscans, beoordeling tegen gepubliceerd beleid en eerste initiatiefplanning uit. Een fase zonder de vereiste voorwaarde kan met uitleg worden overgeslagen. Planning gebruikt de beschikbare bevindingen en beleidsbeoordeling.

Review de voorgestelde hiaten aan de hand van de repository. De eerste initiatieven behandelen ontbrekende mogelijkheden, fundamenten of relevante onopgeloste dependencyproblemen. Het zijn geen nieuwe functies waar niemand om heeft gevraagd.

Behoud bruikbare bestaande mogelijkheden. Wijs een voorstel dat die onnodig opnieuw zou bouwen af of corrigeer het. Voeg voor een nieuwe bedrijfseis een afzonderlijk initiatief toe.

Behoud een op bewijs gebaseerd vertrekpunt

Rond Discovery af en review de initiatiefvoorstellen. Bevestig de omgeving en leveringsverantwoordelijkheden vóór gedetailleerde planning. Houd imports, codewijzigingen en productinstructies tijdens het werk consistent.

Het resultaat is een begrepen vertrekpunt en een aanpasbare backlog. Het is geen verklaring dat al het bestaande gedrag correct is. Ga verder met initiatiefplanning.

Maak de oefening

Een geïmporteerde fictieve service gebruikt een verouderde autorisatiemodule. Vervanging is al gepland. Schrijf een productinstructie die nieuwe afhankelijkheden van de module voorkomt. Benoem daarna één repositoryverwijzing die u in de geïmporteerde specificatie zou controleren.

Werkblad downloaden (Markdown)

Controleer uw begrip

Een geïmporteerd document beschrijft correct code die u wilt vervangen. Wat is de juiste reactie?

Bronnen en verder lezen

Gerelateerd leesmateriaal van Taiga