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.

Sestavený kontext dodržuje rozpočet řádků a každá sekce, kterou vypustí, je pojmenována s důvodem

context.builder_budget_lines omezuje, co majordomus context vypíše. Když by briefing překročil limit, sekce se vypouštějí — ale nikdy potichu a nikdy ty části, bez kterých pracovník pracovat nemůže.

deklarovaný stavdeklarovaný stav: zaručeno Deklarováno jako deterministické a blokující, implementováno a s uvedeným behaviorálním testem, který to má dokázat. Zda to zaznamenaný běh podporuje, říká verdikt důkazů zobrazený vedle.

zaznamenané důkazyzaznamenané důkazy: nespuštěno Deklarováno jako zaručené, ale nepodložené zaznamenaným během: test je pojmenován, ale žádný úspěšný běh nad současnými vstupy zaznamenán není. jak se zaznamenávají důkazy

Počítá se vytištěný dokument, ne jeho sekce. Git, úloha, profil a otevřené blokátory se nikdy nevypouštějí; těla záznamů degradují na odkaz dřív, než zmizí.

Co to znamená

context.builder_budget_lines omezuje, co majordomus context vytiskne. Když by briefing limit překročil, sekce se vypouštějí — ale nikdy tiše a nikdy ty části, bez nichž worker pracovat nemůže.

Princip

Sekce se vypouštějí v pevném pořadí: nedávná historie, pak dotčené soubory, pak rozhodnutí, pak těla kontrolního bodu a předávky. Git, úloha, profil a otevřené blokátory se nevypouštějí nikdy, protože worker, kterému chybějí, není nedostatečně informován, ale dezinformován.

Obě těla záznamů degradují místo toho, aby zmizela: hlavička sekce zůstane a tělo se stane body omitted for budget — read <path>, takže pracovník ví, že záznam existuje a kde ho najít.

Každé vypuštění se připojí do seznamu vyloučení s context budget <n> lines jako důvodem.

Počet se týká dokumentu skutečně vytištěného, včetně hlavičky a patičky — mj_ctx_render zapíše celou stránku do souboru a měří ten soubor, po každém vynechání ji vykreslí znovu. Dřívější verze počítala jen sekce, což nechalo padesátiřádkovou stránku hlásit „40 z 40 řádků“. Rozpočet, který hlásí číslo menší než to, co řídí, je horší než žádný rozpočet.

Pokud je to, co nelze vypustit, stále nad rozpočtem, kontext se přesto vypíše a návratový kód je 10: worker dostane fakta a volající se dozví, že rozpočet nebyl splněn.

Jak to vidět

majordomus context --budget-lines 50 | tail -8
# ## EXCLUDED
# - history — context budget 50 lines
# - decisions — context budget 50 lines
#
# ## BUDGET
# 48 of 50 lines (dropped: history decisions)

# the reported count is the printed count
[ "$(majordomus context --budget-lines 50 | wc -l)" = 48 ]

majordomus context --budget-lines 5 >/dev/null; echo $?   # 10

Co nepokrývá

Řádky, ne tokeny. Briefing se rozpočtuje v řádcích, které umí deterministicky spočítat každý stroj. To, co vybírá samostatný kompilátor kontextu, počítá v tokenech majordomus economics measure (tvrzení context-selection-counted); co to měří a co ne, viz ECONOMICS.md.

Rozpočet řídí briefing, ne to, co pracovník načte potom. Pracovník může číst celý repozitář; nic mu v tom nebrání a nic to neměří.

Proč existuje

Kontext je zdroj, kterému dochází, a dochází mu potichu. Rozpočet, který je jen rada, je přání; rozpočet bez viditelných vyloučení vyrobí záhadně chudý briefing. Pojmenovat obojí — strop i vše, co vás stál — z čísla dělá něco použitelného místo ozdoby.

Detail vykreslený z docs/claims/context-selection-budget.md.

Od tvrzení k důkazu

  1. 1 · veřejné tvrzení

    Sestavený kontext dodržuje rozpočet řádků a každá sekce, kterou vypustí, je pojmenována s důvodem

    Vzniklo na Context, Profiles.

  2. 2 · kanonické tvrzení

    context-selection-budgetdeklarovaný stav: zaručeno v docs/CLAIMS.yaml

    Definováno v přečtěte si na tomto webu · share/skeleton/policy.yaml

  3. 3 · implementace

    lib/context.sh · majordomus context

  4. 4 · test a scénáře

    Test: test/cases/23_context.sh

    Provedeno v Čtěte jen kontext, který se vejde do rozpočtu, a vězte, co bylo vypuštěno.

  5. 5 · zaznamenané běhy

    zaznamenané důkazy: nespuštěno jak se zaznamenávají důkazy

Ověřte si to sami

Test běží v jednorázovém dočasném repozitáři a ověřuje chování, ne řetězec ve zdrojovém kódu.

z klonu repozitáře
bash test/run.sh 23_context

Kde se toto tvrzení používá

Související tvrzení stejná implementace

Okamžiky, na které to odpovídá

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