Was freigegeben werden muss

Nicht jedes Element braucht eine Entscheidung. Eine Regel legt fest, welche freigegeben werden müssen; alle anderen können trotzdem Feedback bekommen, es zählt nur nicht.

Regeln

Regeln nennen Elementarten, all oder Muster und lassen sich auf einige Seiten beschränken:

Regel

Muss freigegeben werden

need

jedes Sphinx-Needs-Objekt

heading, paragraph, item, row, code, note, figure

jedes Element dieser Art

all

alles

sphinx-needs:PROP_*

jedes Element, dessen Selektor zum Muster passt

Pfade docs/technical/*

nur auf diesen Seiten

Die Arten schaltest du im Panel unter Must be approved; Muster und Pfade stehen in der Konfiguration.

Was du siehst

  • Elemente, die freigegeben werden müssen und noch kein Feedback haben, tragen eine graue gestrichelte Linie neben sich.

  • Das Panel listet die ohne Urteil unter To review, Seite für Seite oder für das ganze Projekt.

  • Ein Balken zeigt zwei Anteile der Pflicht-Elemente: Verdict – wie viele überhaupt ein Urteil bekommen haben (freigeben, ablehnen, freigeben & einfrieren, löschen) – und Quality – wie viele Sterne bekommen haben.

  • Die Karte eines solchen Elements sagt must be approved.

Fakten

Eine Wissensbasis hält ihre geprüften Fakten in Faktendateien – standardmäßig jede Markdown-Datei in einem 20_facts/-Ordner, ohne die Verzeichnisse (_index.md). Darin ist jeder Listenpunkt, jede Tabellenzeile und jeder freie Absatz ein Fakt (Ein Fakt ist ein Block eine... (DEC_FACT_BLOCKS)), und jedes zählt in einer Gruppe:

Gruppe

Das Fakt …

approved

ist freigegeben (oder eingefroren) und seitdem unverändert

open

hat noch kein Urteil oder einen Auftrag für die KI

stale

hat sich seit der Freigabe geändert

question

hat eine offene Frage

unverified

enthält einen [ASSUMPTION]-Marker – eine Freigabe bestätigt die Markierung, nicht das Fakt

Eine Faktendatei kann auch als Ganzes freigegeben werden; diese Freigabe veraltet bei jeder Änderung der Datei, die Fakten darin behalten ihren eigenen Zustand. deciwa facts zählt die Gruppen je Ordner und Datei, deciwa approve-facts gibt jedes noch nicht freigegebene Fakt frei. In monsterbrain zeigt die Fakten-Ansicht sie Datei für Datei (monsterbrain).

Welche Dateien und Arten zählen, steht in .deciwa/config.toml:

[facts]
paths = ["20_facts/*.md", "*/20_facts/*.md"]   # * also matches /
exclude = ["*/_index.md", "_index.md"]
kinds = ["item", "row", "paragraph"]
Gestrichelte Linien neben Pflicht-Needs ohne Urteil

Pflicht-Needs ohne Urteil tragen eine graue gestrichelte Linie.