Preskoči na sadržaj

Pojmovnik

Dnevnik izmjena (changelog)

Datiran i numerisan spisak izmjena u proizvodu, koji vodi onaj ko ga objavljuje — najkraći odgovor na pitanje je li ispravka stvarno izašla.

Riječ je o primarnom izvoru, i u tome je sva vrijednost. Bilješka uz izdanje nosi broj verzije i datum; tekst koji je prepričava obično ne nosi ni jedno ni drugo, pa tvrdnja „greška je popravljena“ nema uz šta da se provjeri. Kad se dnevnik izmjena i najava ne slažu, dnevnik je u pravu: najava se piše prije objave, a dnevnik poslije nje.

U svakom zapisu vrijedi pročitati tri stvari. Šta je prekinuto, pod nazivom breaking changes. Šta se gasi, pod nazivom deprecations. I da li je verzija objavljena ili se tek pušta dijelu korisnika — to posljednje objašnjava najviše zabune, jer verzija može danima stajati u dnevniku prije nego što stigne do tvog naloga.

Portalu ovakve vrste dnevnik izmjena je i najbrži korak provjere. Broj verzije pretvara vijest u nešto što čitalac može provjeriti za pola minuta; njegovo odsustvo istu vijest pretvara u tvrdnju.