Incorporeu una base de codi existent a Taiga
CompletadaReviseu què dedueix Taiga d'un repositori. Separeu el comportament actual del desitjat i trieu la resposta adequada a un document inexacte.
Publicat per TaigaCom escrivim
Comproveu què heu entèsUn document importat descriu correctament codi que voleu substituir. Quina és la resposta adequada?Feu l'exercici
Què aprendreu
- Prepareu un repositori vinculat per a un producte importat.
- Distingiu un defecte de codi, una instrucció permanent i un error d'anàlisi.
- Reviseu les iniciatives proposades respecte de les mancances reals i les capacitats existents.
Comenceu pel sistema que teniu
Ja existeix un servei fictici de sol·licituds d’equipament. L’equip vol mantenir-lo amb Taiga preservant les integracions que funcionen.
Trieu Import codebase quan creeu el producte. Vinculeu el repositori i inicieu l’anàlisi. Aquesta via fa servir l’anàlisi del repositori en lloc de la conversa de producte nou. Un producte creat des de zero no incorpora aquesta via d’importació més endavant.
Confirmeu l’accés al repositori i la branca sobre la qual ha de treballar Taiga. Afegiu les restriccions permanents al nivell de context adequat. En aquest exemple, indiqueu que s’ha de mantenir la integració existent d’identitat dels empleats.
Reviseu primer l’especificació inferida
Taiga deriva els documents del producte a partir del codi i hi inclou citacions del repositori. Aquestes citacions us ajuden a comprovar la interpretació. No estableixen la intenció de negoci darrere de cada patró existent.
Examineu tres aspectes de l’especificació:
- Finalitat: L’objectiu descrit coincideix amb el motiu pel qual existeix el servei?
- Restriccions: Quins patrons són requisits deliberats?
- Defectes coneguts: Quins comportaments actuals han de canviar?
El servei d’equipament conté un mòdul d’autorització antic. Un document pot informar-ne de l’ús correctament. Això no vol dir que l’equip l’hagi d’ampliar.
Obriu un fitxer citat i compareu el comportament pertinent amb l’afirmació. Registreu les limitacions de les evidències disponibles, com ara la configuració o el comportament operatiu que queden fora del repositori.
Trieu la correcció adequada
| Situació | Resposta |
|---|---|
| El document descriu correctament codi no desitjat | Planificar i implementar el canvi de codi |
| L’equip té una regla permanent per a la feina futura | Posar la regla a les instruccions del producte |
| L’anàlisi ha interpretat malament el repositori | Fer servir Refresh this document i examinar-ne el resultat |
Els documents importats segueixen el codi. No els tracteu com a descripcions mantingudes manualment d’un sistema futur. Actualitzar un document també torna a derivar els documents dels quals depèn. Per tant, actualitzar un document posterior pot requerir més feina.
Per al mòdul antic, una instrucció podria dir: «No afegiu nous components que cridin el mòdul d’autorització antic. Feu servir la interfície de substitució aprovada per a la feina nova.» Verifiqueu que la interfície existeix i indiqueu-ne la ubicació real al repositori.
Avalueu les primeres iniciatives
El flux d’importació també executa anàlisis del repositori, una avaluació respecte de les polítiques publicades i la planificació inicial d’iniciatives. Una etapa que no tingui el prerequisit corresponent es pot ometre amb una explicació. La planificació fa servir les troballes i l’avaluació de polítiques disponibles.
Reviseu les mancances proposades respecte del repositori. Les iniciatives inicials aborden capacitats absents, fonaments o problemes pertinents de dependències encara sense resoldre. No són una llista de funcionalitats noves que ningú no ha demanat.
Manteniu les capacitats existents que siguin útils. Rebutgeu o corregiu una proposta que les reconstruiria innecessàriament. Afegiu una iniciativa separada per a un nou requisit de negoci.
Preserveu un punt de partida basat en evidències
Finalitzeu Discovery i reviseu les propostes d’iniciativa. Confirmeu l’entorn i les responsabilitats de lliurament abans de la planificació detallada. Manteniu coherents les importacions, els canvis de codi i les instruccions del producte a mesura que avança la feina.
El resultat és un punt de partida entès i una llista de feina pendent que es pot editar. No és una declaració que tot el comportament existent sigui correcte. Continueu amb la planificació d’iniciatives.
Feu l'exercici
Un servei fictici importat fa servir un mòdul d'autorització antic. Ja se n'ha planificat la substitució. Escriviu una instrucció de producte que impedeixi crear dependències noves d'aquest mòdul. Després identifiqueu una citació del repositori que examinaríeu a l'especificació importada.
Descarrega la fitxa (Markdown)Desmarcar aquesta opció elimina tot el progrés desat en aquest navegador.
El progrés es queda en aquest navegador. Sense compte ni seguiment.