Cesta 07Lekce 2 / 8

Přeneste existující kódovou základnu do Taigy

Zkontrolujte, co Taiga odvodí z repozitáře. Oddělte současné a zamýšlené chování a zvolte správnou reakci na nepřesný dokument.

Praxe11 minZkontrolováno

Vydává Jak píšeme

Ověřte si porozuměníImportovaný dokument správně popisuje kód, který chcete nahradit. Jaká reakce je vhodná?Vypracovat cvičení
Importovaný dokument správně popisuje kód, který chcete nahradit. Jaká reakce je vhodná?

Co se naučíte

  • Připravit připojený repozitář pro importovaný produkt.
  • Rozlišit chybu v kódu, trvalý pokyn a chybu analýzy.
  • Posoudit navržené iniciativy podle skutečných nedostatků a existujících schopností.

Začněte systémem, který máte

Fiktivní služba pro žádosti o vybavení už existuje. Tým ji chce udržovat s Taigou a zachovat funkční integrace.

Při vytváření produktu zvolte Import codebase. Připojte repozitář a spusťte analýzu. Tento postup používá analýzu repozitáře místo konverzace pro nový produkt. U produktu vytvořeného od začátku nelze tento import přidat později.

Potvrďte přístup k repozitáři a větev, se kterou má Taiga pracovat. Přidejte trvalá omezení na příslušnou úroveň kontextu. V tomto příkladu uveďte, že existující integrace identity zaměstnanců musí zůstat v provozu.

Nejprve zkontrolujte odvozenou specifikaci

Taiga odvozuje dokumenty produktu z kódu a připojuje odkazy na repozitář. Tyto odkazy pomáhají ověřit interpretaci. Neprokazují obchodní záměr za každým existujícím postupem.

Ve specifikaci zkontrolujte tři věci:

  • Účel: Odpovídá popsaný cíl důvodu, proč služba existuje?
  • Omezení: Které postupy jsou záměrnými požadavky?
  • Známé chyby: Které současné chování se má změnit?

Služba pro vybavení obsahuje zastaralý autorizační modul. Dokument může jeho použití popisovat správně. To neznamená, že jej tým má dále rozšiřovat.

Otevřete odkazovaný soubor a porovnejte příslušné chování s tvrzením. Zaznamenejte omezení dostupných důkazů, například konfiguraci nebo provozní chování mimo repozitář.

Zvolte správnou opravu

SituaceReakce
Dokument správně popisuje nežádoucí kódNaplánujte a implementujte změnu kódu
Tým má trvalé pravidlo pro budoucí práciUložte pravidlo do pokynů produktu
Analýza chybně vyložila repozitářPoužijte Refresh this document a zkontrolujte výsledek

Importované dokumenty vycházejí z kódu. Nepovažujte je za ručně udržované popisy budoucího systému. Obnovení dokumentu také znovu odvodí dokumenty, na kterých závisí. Obnovení pozdějšího dokumentu proto může vyžadovat více práce.

Pro zastaralý modul může pokyn znít: „Nepřidávej nové komponenty, které volají zastaralý autorizační modul. Pro novou práci používej schválené náhradní rozhraní.“ Ověřte, že rozhraní existuje, a uveďte jeho skutečné umístění v repozitáři.

Posuďte první iniciativy

Import také spouští skenování repozitáře, posouzení podle publikovaných zásad a počáteční plánování iniciativ. Fáze bez potřebného předpokladu může být přeskočena s vysvětlením. Plánování používá dostupné nálezy a posouzení zásad.

Porovnejte navržené nedostatky s repozitářem. Počáteční iniciativy řeší chybějící schopnosti, základy nebo relevantní nevyřešené problémy se závislostmi. Nejsou seznamem nových funkcí, které nikdo nepožadoval.

Zachovejte užitečnou existující schopnost. Odmítněte nebo opravte návrh, který by ji zbytečně znovu vytvářel. Pro nový obchodní požadavek přidejte samostatnou iniciativu.

Zachovejte výchozí stav podložený důkazy

Dokončete Discovery a zkontrolujte návrhy iniciativ. Před podrobným plánováním potvrďte prostředí a odpovědnosti za dodávku. Během práce udržujte soulad importů, změn kódu a pokynů produktu.

Výsledkem je pochopený výchozí stav a upravitelný backlog. Není to prohlášení, že veškeré existující chování je správné. Pokračujte plánováním iniciativ.

Vypracovat cvičení

Importovaná fiktivní služba používá zastaralý autorizační modul. Jeho náhrada je už naplánovaná. Napište pokyn produktu, který zabrání novým závislostem na modulu. Potom určete jeden odkaz na repozitář, který byste v importované specifikaci zkontrolovali.

Stáhnout pracovní list (Markdown)
Ověřte si porozumění ↑

Pokračovat v učení

Zdroje a další čtení

Související čtení od Taigy

← Předchozí lekce: Vytvořte nový produkt v Taize