Polku 07Oppitunti 2 / 8

Tuo nykyinen codebase Taigaan

Tarkasta Taigan reposta johtamat tiedot. Erota nykyinen toiminta tavoitellusta ja valitse oikea korjaustapa dokumentin virheeseen.

Käytännön työ11 minTarkistettu

Julkaisija Näin kirjoitamme

Mitä opit

  • Valmistele liitetty repo import-tuotteelle.
  • Erota koodivirhe, pysyvä ohje ja analyysivirhe.
  • Vertaa ehdotettuja initiativeja todellisiin puutteisiin ja nykyisiin kyvykkyyksiin.

Aloita nykyisestä järjestelmästä

Kuvitteellinen työvälineiden pyyntöpalvelu on jo olemassa. Tiimi haluaa ylläpitää sitä Taigalla ja säilyttää toimivat integraatiot.

Valitse tuotetta luodessa Import codebase. Liitä repo ja käynnistä analyysi. Tämä polku käyttää repoanalyysia uuden tuotteen keskustelun sijaan. Tyhjästä luotuun tuotteeseen ei lisätä tätä import-polkua myöhemmin.

Varmista pääsy repoon ja oikea työskentelybranch. Lisää pysyvät rajoitteet sopivalle kontekstitasolle. Esimerkissä nykyisen työntekijäidentiteetin integraation pitää säilyä.

Tarkasta specification ensin

Taiga johtaa dokumentit koodista ja liittää mukaan repoviitteet. Viitteet auttavat tarkistamaan tulkinnan. Ne eivät osoita jokaisen nykyisen ratkaisun liiketoiminnallista tarkoitusta.

Tarkasta specificationista kolme asiaa:

  • Tarkoitus: Vastaako kuvattu tavoite palvelun olemassaolon syytä?
  • Rajoitteet: Mitkä käytännöt ovat tarkoituksellisia vaatimuksia?
  • Tunnetut virheet: Minkä nykyisen toiminnan pitää muuttua?

Palvelussa on legacy-authorization-moduuli. Dokumentti voi kuvata sen käytön oikein. Se ei tarkoita, että moduulia pitäisi laajentaa.

Avaa viitattu tiedosto ja vertaa toimintaa väitteeseen. Kirjaa näytön rajat, kuten repon ulkopuolinen konfiguraatio tai ylläpidon toiminta.

Valitse oikea korjaus

TilanneToimi
Dokumentti kuvaa ei-toivotun koodin oikeinSuunnittele ja toteuta koodimuutos
Tiimillä on tulevaa työtä koskeva pysyvä sääntöKirjaa se product instructioneihin
Analyysi tulkitsi repon väärinValitse Refresh this document ja tarkasta tulos

Import-dokumentit seuraavat koodia. Ne eivät ole käsin ylläpidettäviä tavoitetilan kuvauksia. Refresh johtaa uudelleen myös dokumentin riippuvuudet. Ketjun myöhemmän dokumentin päivitys voi siksi vaatia enemmän työtä.

Legacy-moduulin ohje voisi olla: ”Älä lisää uusia kutsujia legacy-authorization-moduuliin. Käytä uusissa muutoksissa hyväksyttyä korvaavaa rajapintaa.” Varmista rajapinnan olemassaolo ja nimeä sen oikea sijainti repossa.

Arvioi ensimmäiset initiativet

Import ajaa myös reposkannaukset, arvioinnin julkaistuja policyja vasten ja ensimmäisten initiativejen suunnittelun. Vaihe voidaan ohittaa perustellusti, jos sen edellytys puuttuu. Suunnittelu käyttää saatavilla olevia havaintoja ja policy-arviointia.

Vertaa ehdotettuja puutteita repoon. Ensimmäiset initiativet koskevat puuttuvia kyvykkyyksiä, perustaa tai olennaisia riippuvuusongelmia. Ne eivät ole lista pyytämättömiä uusia ominaisuuksia.

Säilytä toimiva kyvykkyys. Korjaa ehdotus, joka rakentaisi sen turhaan uudelleen. Lisää uudelle liiketoimintatarpeelle oma initiative.

Säilytä näyttöön perustuva lähtötilanne

Viimeistele Discovery ja tarkasta ehdotukset. Varmista ympäristö ja toimitusvastuut ennen yksityiskohtaista suunnittelua. Pidä importin tiedot, koodi ja instructionit linjassa työn edetessä.

Tuloksena on ymmärretty lähtötilanne ja muokattava backlog. Se ei ole vakuutus nykyisen toiminnan virheettömyydestä. Jatka initiativejen suunnitteluun.

Sovella käytäntöön

Kuvitteellisen import-tuotteen authorization käyttää legacy-moduulia, jonka korvaus on jo suunnitteilla. Kirjoita product instruction, joka estää uudet riippuvuudet moduuliin. Valitse sitten yksi specificationin repoviite tarkastettavaksi.

Lataa työpohja (Markdown)

Testaa, mitä opit

Import-dokumentti kuvaa oikein koodia, jonka haluat korvata. Miten toimit?

Lähteet ja lisälukeminen

Aiheesta Taigan sivuilla