Registro delle modifiche del calcolatore di valutazione degli scacchi

Questo registro delle modifiche registra cinque categorie di aggiornamenti: modifiche al profilo delle regole (quando una federazione aggiorna i suoi regolamenti e creiamo un nuovo profilo con versione), correzioni alla logica di calcolo (correzioni all'implementazione della formula, al comportamento di arrotondamento o alla gestione dei casi limite), espansioni della suite di convalida (nuovi scenari di test aggiunti alla pipeline di verifica automatizzata), nuove funzionalità del calcolatore (modalità aggiuntive, opzioni di esportazione o funzionalità di input) e aggiornamenti dei contenuti (revisioni significative alle pagine didattiche che modificano la guida ricevuta dagli utenti). Per provare l’idea con dati reali, usa calcolatori Elo.

Le modifiche estetiche come gli aggiornamenti dello stile visivo, le ottimizzazioni delle prestazioni che non influiscono sugli output e le modifiche all'infrastruttura non vengono registrate qui a meno che non abbiano un effetto visibile sull'esperienza dell'utente.

Ogni voce include la data della modifica, l'area interessata (calcolatrice, contenuto, profilo delle regole o convalida), una descrizione di cosa è cambiato e perché e collegamenti alle pagine pertinenti. Le voci che influiscono sugli output dei calcoli vengono contrassegnate con un tag di "interruzione" in modo che gli utenti possano identificare rapidamente le modifiche che potrebbero spiegare una differenza tra un risultato precedente e quello attuale.

Se stai confrontando un risultato salvato da una visita precedente con un ricalcolo odierno e i numeri differiscono, inizia da qui. Il registro delle modifiche ti dirà se un profilo di regole è stato aggiornato, un comportamento di arrotondamento è stato corretto o un nuovo caso limite è stato gestito in modo diverso.

Un registro delle modifiche visibile e ben mantenuto è uno dei segnali di fiducia più forti che un sito di calcolo possa offrire. Dimostra che il sito è mantenuto attivamente, che le modifiche sono documentate anziché nascoste e che gli utenti possono sempre far risalire una differenza nell'output a una modifica specifica e datata. Ciò è particolarmente importante per gli allenatori e gli organizzatori che potrebbero dover spiegare ai giocatori perché un ricalcolo produce un risultato leggermente diverso rispetto al controllo precedente.

Il registro delle modifiche funziona di pari passo con la pagina della metodologia: la metodologia spiega come funzionano i calcolatori e il registro delle modifiche spiega come tale implementazione si è evoluta nel tempo.