clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 48
colibri/docs/wiki/sl/quality-gates.md
Sam & Claude 3acb991196 docs(sl): fix quality-gates — vrata→preverjanje, krajevni→lokalni 
"Vrata" is a correct translation for TCP/network ports, but wrong for
software quality gates. Changes:

quality-gates.md — rewritten: "kakovostno preverjanje" not "kakovostna vrata"
  vrata → preverjanje (gate → verification)
  krajevna → lokalno (local)
  kljuka → kavelj (door handle → git hook)
  padejo → spodleti (falls → fails)

Scattered fixes in 5 other files:
  cost-model.md, index.md, mother-hive.md, naming-decisions.md,
  store-schema.md — vrata → preverjanje/dovoljenja
  external-mcp.md — vrata → dovoljenja (permissions)

Kept: "vrata" for TCP ports (correct), "vhodna vrata" for front-door
metaphor (works in Slovenian), "vrata za poslušanje" for listening port.

Also fixed: frontmatter quoting for YAML (nested quotes, colons).
2026-06-26 14:15:47 +02:00

2.1 KiB
Raw Blame History

title description
Kakovostno preverjanje Sprememba ni končana brez uspešnega lokalnega preverjanja — cargo fmt, clippy, cargo test, markdown, wiki-lint.

← kazalo

Odločitev

Sprememba ni "končana", dokler ne prestane lokalnega preverjanja:

./scripts/ci-checks.sh   # cargo fmt --check, clippy -D warnings, cargo test, markdown gate, wiki-lint --strict

Predpotisni kavelj (scripts/pre-push) zažene isto preverjanje ob vsakem git push na main — aktiviraj enkrat na klon z ./scripts/install-hooks.sh. Kavelj zavrne potisk, če katerokoli preverjanje spodleti; obidi samo v sili z --no-verify.

.forgejo/workflows/ci.yml kodira ista preverjanja, vendar noben izvajalnik Forgejo Actions ni registriran, zato nič ne uveljavlja preverjanj strežniško. Dokler izvajalnik ni aktiven, sta lokalno preverjanje + predpotisni kavelj uveljavitvena plast. Navedeno kot obvezno v AGENTS.md.

Zakaj ta stran obstaja

Napaka pri prevajanju (pi_binary nedefiniran, iz napol dokončanega preimenovanja) je dosegla main, ker je bilo preverjanje preskočeno in neuveljavljeno. Ista revizija je ugotovila, da sta bili obe preverjanji takrat dejansko rdeči na main:

  • clippy -D warnings je padel na predobstoječem lintu → Rust preverjanje bi padlo za vsakogar, ki bi ga zagnal.
  • markdown preverjanje je padlo na prettier-umazanih dokumentih.

Oboje je bilo spravljeno v zeleno, zato je preverjanje zdaj dejansko zagonljivo. Nauk: preverjanje, ki ga nihče ne poganja (in je tako ali tako rdeče), je korenski vzrok, da odmik doseže main — bolj kot vsak posamezen spodrsljaj pri poimenovanju.

Odnos do tega wikija

Imenik naming-decisions + wiki-lint --strict sta pomenska protiutež ci-checks.sh: prevajalnik/clippy ujameta zlomljeno kodo, ne pa dokumenta, ki še vedno opisuje staro zasnovo, ali imena, ki je odneslo. Wiki lint pokriva to vrzel. Zdaj je del obveznega preverjanja — napaka odmika blokira potisk, enako kot opozorilo clippy.

Glej tudi