Workflow Náboja #14
Description
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.