Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Dokumentace a drift

Zda napsané stále popisuje to, co existuje, a kolik kopií toho existuje.

Dokumentace a drift

Každá ručně udržovaná kopie faktu je kopie, která zastará, a čtenář nepozná, která je aktuální. Tato oblast pokrývá duplicitní vysvětlení, odkazy popisující chování, které kód už nemá, a tvrzení na stránce, za kterým nestojí žádný test.

8 okamžiků

Každý okamžik, který pojmenovává tento. Odvozeno z okamžiků; tato stránka žádný seznam nevede.

  1. četli jste tři plány rozvoje jednoho projektu a nevěřili žádnémuPlán vedený jako próza je snímek a každá jeho kopie se rozchází svým tempem; uložený stav je tvrzení, které platí i poté, co se svět pohnul. cena: středníběžné Proč a co s tím →
  2. změnili jste politiku na jednom místě a na třech dalších stále platila staráRozhodnutí se aktualizuje u zdroje a generované kopie dál servírují předchozí verzi, aniž by rozdíl cokoli hlásilo. cena: vysokáběžné Proč a co s tím →
  3. přečetl v README slib, za kterým nestál žádný testVěta popisující, co software dělá, se napíše jednou a nikdy se nepropojí s ničím, co by selhalo, kdyby přestala platit. náklady: vysokéběžné Proč a co s tím →
  4. vydal změnu rozhraní, jejíž dokument kontraktu stále popisoval to staréKontrakt udržovaný ručně vedle kódu, který popisuje, zastará při první změně, která na něj zapomene. náklady: vysokéběžné Proč a co s tím →
  5. vložil příkaz z dokumentace a sledoval, jak selhalPříklady se píšou jednou, v próze, a nic je už nikdy nespustí. náklady: středníběžné Proč a co s tím →
  6. měli zelený pipeline nad vygenerovanými soubory, které už neodpovídaly svým zdrojůmTesty procvičují kód a neříkají nic o commitnutých výstupech z něj odvozených, takže build je zelený a artefakty špatně. náklady: středníčasté Proč a co dělat →
  7. nalezeno totéž vysvětlené třikrát, pokaždé trochu jinakKaždá ručně udržovaná kopie faktu driftuje podle vlastního rozvrhu a čtenář nepozná, která kopie je aktuální. náklady: střednístálé Proč a co dělat →
  8. publikoval stránku, která slibovala víc, než by jakýkoli test uneslVeřejný materiál vzniká jiným úkonem než kód, takže ujíždí před chování a nic ho nevrací zpět. náklady: vysokéběžné Proč a co s tím →

Prohledává názvy a popisy všech stránek, které tento web publikuje.