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.

Těžce získaný poznatek, který se nikdy nestal znalostí

Pracovník se o kódové základně dozví něco drahého, jednou to využije a s relací to zanikne, protože to nikdo nepřevedl na trvalý záznam.

→ strávili jste hodinu objevováním něčeho, co repozitář už věděl, a to dvakrát

cena, když k tomu dojde
střední
jak často
běžné
oblast
kontext

Okamžik

Worker stráví hodinu zjišťováním, proč je integrační test nestabilní — závislost na hodinách o tři vrstvy níž — opraví to a řekne to. O šest týdnů později se stejná nestabilita vrátí v jiném testu a někdo stráví tu hodinu znovu.

Proč k tomu dochází

Nebylo kam nález dát, aby se na něj někdo podíval. Komentář v kódu to řekne tomu, kdo ten soubor otevře; zpráva v chatu tomu, kdo byl přítomen; stránka wiki tomu, kdo hledá správná slova. Žádné z toho další worker nenačte, takže výchozím výsledkem každého objevu je, že se vypaří.

Proč to lepší model nevyřeší

Objev byl poprvé učiněn správně. Selhání je celé mezi relacemi: nic nepřeměnilo nález v něco, co dostane další pracovník. Lepší modely činí znovuobjevování rychlejším a o nic méně opakovaným.

Co to stojí

Pokaždé hodina. A jemnější náklad: protože znovuobjevování je normální, pracovníci přestanou brát existující kód jako důkaz dřívějšího rozhodnutí a začnou každé omezení brát jako něco, co je třeba obejít.

Co Majordomus dělá

Znalost je deklarovaný druh, ne složka poznámek. majordomus knowledge zaznamenává jedno trvalé tvrzení o repozitáři s třídou tvrzení — fact, convention, constraint, memory nebo lesson — způsobem, jak se ví (observed, inferred, decided), a mírou potvrzení. Záznam se stavem verified musí pojmenovat důkazy, proti nimž byl potvrzen; nic se nepotvrdí tím, že bylo zapsáno.

Zdroje znalostí se deklarují v jednom souboru, takže objevování probíhá přes index verzovacího systému, ne přes souborový systém: nesledovaný pomocný soubor není znalost a dva stroje vidí stejný seznam ve stejném pořadí. majordomus context čerpá ze záznamů třídy memory, když skládá, co bude další pracovník potřebovat.

Před a po

before   finding -> session -> nothing

after    majordomus knowledge add "the integration clock is injected, not read" \
           --class fact --epistemics observed --evidence test/cases/42_clock.sh
         # class memory records are offered to the next context, within budget

Jak to ověřit

Zaznamenejte nález a začněte novou relaci: majordomus context ho nabídne. Označte záznam verified bez důkazů a bude odmítnut.

Co nedělá

Nevytahuje znalosti z přepisu a žádný neukládá. Strojová extrakce vytvoří candidate, nikdy záznam verified — potvrzení je úkon člověka, opřený o pojmenované důkazy.

Jak to vypadá

Konkrétní situace, jedna pro každé publikum. Každá je deklarována v záhlaví okamžiku, takže stav před a po jsou data, ne próza, od které by se stránka mohla odchýlit.

  1. Proč je ten test nestabilní ai-native-team

    před
    Worker stráví hodinu zjišťováním, že nestabilní test závisí na hodinách; zjištění se uvede v relaci a ztratí se s ní.
    po
    Nález je záznam znalosti třídy `fact` s jeho důkazy a další worker se jím sestavuje.
  2. Zvláštnost buildu klienta agency

    před
    Build potřebuje přepínač, který nikdo nezdokumentoval; každý nový člověk na účtu ho znovu objevuje za cenu odpoledne.
    po
    Je to znalostní záznam třídy `constraint` — něco vně repozitáře, co ho omezuje — který `search` najde za pár sekund.
  3. Přístup, který nemůže fungovat research-team

    před
    Postup je vyloučen z dobrého technického důvodu; o šest týdnů později se o něj někdo pokusí znovu.
    po
    Záznam nese třídu `lesson` a co dřívější pokus stál, takže druhý pokus nezačne.

Jak to poznáte

Pozorovatelné příznaky, které tento okamžik deklaruje. Jsou dotazníkem na indexu a vstupem pro majordomus why diagnose; nic jiného je nedefinuje.

  • Něco nezřejmého o této kódové bázi bylo zjištěno od nuly, ačkoli to už jednou zjištěno bylo. rediscovered
  • Worker se naučil něco, co stojí za uchování, a nebylo kam to zjevně dát. no-place-to-put-it
  • Užitečné poznatky z relace existují jen uvnitř té relace. findings-in-chat

Kde to v nástroji najdete

Vše níže je načteno z vlastního záhlaví tohoto okamžiku a ověřeno proti repozitáři. Neexistující název by neprošel validací.

příkazy, které na to odpovídají

schopnosti spustitelného souboru, které na to odpovídají

co dohlíží — odvozeno z tvrzení níže

tvrzení, která tuto stránku podpírají, a důkazy za každým z nich

pravidla, která jej řídí

  • majordomus.externalise-decisions
  • project.never-store-transcripts
  • majordomus.minimum-sufficient-context

případy užití, které ukazují cestu ven

Pokud vám tohle zní povědomě, další také

Co tento okamžik pojmenovává, co pojmenovává jeho a co sdílí jeho oblast, publikum nebo štítky. Druhé a třetí je odvozeno; zapsáno je jen první.

Všech 38 a jak souvisejí s nástrojem →

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