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.

Rozhodnutí existuje, v konverzaci, kterou nikdo nenajde

Rozhodnutí, k němuž se dospělo v relaci, se uloží tam, kde ho přečte jen tato relace, takže ho nelze ani přezkoumat, ani objevit.

→ šel hledat, proč jsme to zvolili, a našel chat log

cena, když k tomu dojde
vysoká
jak často
konstanta

Okamžik

Někdo se ptá, proč služba zapisuje do fronty před databází, a ne po ní. Odpověď je známa — jednou byla pečlivě vypracována — a jediné místo, kde existuje, je konverzace, která mezitím byla uzavřena.

Proč k tomu dochází

Zaznamenání rozhodnutí je jiný akt než jeho učinění a přichází ve chvíli, kdy jsou všichni zúčastnění přesvědčeni, že si ho zapamatují. Pamatují, asi čtrnáct dní. Mezitím existující artefakt je přepis, který je dlouhý, neindexovaný a psaný v rejstříku rozhovoru, ne záznamu.

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

Model dokáže shrnout přepis do něčeho, co vypadá jako záznam o rozhodnutí, ale výsledek je rekonstrukce bez váhy: nerozliší, co bylo rozhodnuto a co se jen probíralo, a nic ho neváže ke commitu, na který se vztahoval.

Co to stojí

Rozhodnutí se znovu obhajuje (což je vlastní okamžik) nebo, hůř, tiše popírá. A protože důvod není k dispozici, další člověk nerozliší záměrné omezení od nehody, takže všechna omezení pokládá za nehody.

Co Majordomus dělá

majordomus decision add zaznamená, co bylo rozhodnuto, a odmítne to zaznamenat bez --why. --rejected zaznamená alternativu, která byla vyloučena; --evidence říká, kde hledat. Id úlohy a git head se počítají, nikdy nepíšou, a záznamy jsou pouze přidávací: --supersedes zaznamená náhradu a odmítne odkázat na rozhodnutí, které neexistuje. Rozhodnutí dost trvalé na to, aby přežilo úlohu, se povýší na architektonické rozhodnutí pod vrstvou, s kontextem, alternativami a důsledky, a adr propose jej navrhne z lokálního záznamu, ne z prózy.

Před a po

before   "we discussed it in the design session"     (which one?)

after    $ majordomus search "queue before database" --kind decision
         t-…a4f1  head=8c31f0e
           decided:  write to the queue before the database
           why:      a lost enqueue is recoverable; a lost row is not
           rejected: writing after, which loses the event on a crash between the two

Co nedělá

Nerozhoduje, co stojí za zaznamenání, a netěží přepisy. Práh je úsudek, který repozitář vyjadřuje jako pravidlo; nástroj odmítne rozhodnutí bez důvodu a nikdy neukládá konverzaci.

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. Designová konverzace solo-builder

    před
    Hodina návrhového uvažování přinese dobré rozhodnutí a žije v okně, které se ten večer zavře.
    po
    `decision add` zaznamená volbu, její důvod a zamítnutou alternativu; head a úloha se počítají z gitu.
  2. Předání uvažování agency

    před
    Zakázka skončí a klient zdědí kód, jehož omezení nemají uvedené důvody.
    po
    Trvalá rozhodnutí jsou záznamy v repozitáři a ta významná se povyšují na architektonická rozhodnutí s kontextem a důsledky.
  3. Kdo rozhodl a na jakém základě enterprise

    před
    Původem návrhové volby je snímek obrazovky konverzace.
    po
    Záznam nese rozhodnutí, důvod, zamítnutou alternativu, úlohu a commit a je jen pro připojování.

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.

  • Odpovědí na „proč je to postaveno takto“ je log konverzace. answer-is-a-log
  • Významná rozhodnutí se dělají bez jakéhokoli trvalého záznamu zamítnuté alternativy. no-adr
  • Rozhodnutí bylo učiněno a nikdo nemůže najít, kde. cannot-find-it

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.decision-records
  • majordomus.adr-integrity
  • majordomus.externalise-decisions
  • project.never-store-transcripts
  • majordomus.decision-threshold

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.