Workflow Náboja

[sesquideus]

Momentálny workflow pri tvorbe Náboja je prinajlepšom tristný. Chcelo by to masívny overhaul celého procesu, ako sa zadania vytvárajú. Hlavný problém je podľa mňa absencia SSOT: časť dát je v príkladových metadátach, časť v Google sheetoch, niečo nikde.

Ako by to mohlo fungovať

Navrhujem ukladať progress v YAML metadátach priamo v súboroch príkladov. Zároveň by to ale chcelo stránku, kde sa bude zobrazovať komplexný pohľad na to, čo je a čo nie je hotové. Tá by ideálne bežala na rovnakom mieste, ako DeGeŠ, a takisto priamo updatovala PDF output.

Implementácia

Teda v príklade by pribudol YAML header, niečo ako

---
author: Kvík
wording: Jaro
genre: mechanics
type: number
picture: none
check:
    wording: [Dušan, Adam, Kiko]
    grammar: [Mary]
    style: [Kvík]
comments:
    Kvík:
        - "nesprávne použitý `siunitx`"
        - "nejde skompilovať"
    Jaro:
        - "chceme uznávať aj približný výsledok"
    Adam:
        - "predminulé trpné príčastie podmieňovacie je blbosť"
difficulty:
    Kvík: 5
    Jaro: 12
    Plyš: 10
---

Plyštína minule našla v záhrade ježka v tvare gule s polomerom blah blah blah...

Obdobne sa to môže spraviť pre ďalšie súbory (solution.md, answer.md). Formát by bol fixný, treba vydiskutovať, čo všetko tam chceme.

Vizualizácia

Po každom commite (prípadne on-request) server-side skript (Github Action / Python, for fuck's sake...) rozparsuje všetky zmenené príklady a updatuje jednoduchú HTML tabuľku pre zodpovedajúci ročník. Automaticky by to riešilo napríklad požiadavku na minimálne tri kontroly vzoráku, problémy s obtiažnosťou a dokonca z veľkej časti aj problémy s blbým internetom.