Számok, dátumok és időpontok
Az 1.10 verziószám: miért marad meg a pont és a nulla?
A program 1.10 jelölése verzióazonosító lehet, ezért a pontját ne cseréld automatikusan tizedesvesszőre, és a végét se rövidítsd 1.1-re. A verzió részeinek jelentését a kiadó jelölési rendszere határozza meg. Magyar szövegben a pontos jelölést őrizzük meg: az 1.10 verzió.
A cikk tartalma
Azonosítót olvasol, nem mennyiséget
Egy mért értékben az 1,10 és az 1,1 ugyanazt a számértéket fejezheti ki. Egy programváltozatnál viszont az 1.10 és az 1.1 két külön címke. A verziószám pontja tagolójel, amely a jelölési rendszer részeit választja el.
Az AkH. lehetőséget hagy az egyedi azonosítási rendszerek saját alakjára. Ezért a közönséges tizedes törtek magyar írásmódját itt nem alkalmazhatjuk gondolkodás nélkül. Először nézd meg a kiadó vagy a dokumentumgazda által megadott pontos változatjelölést.
A sorrendhez ismerni kell a rendszert
A szemantikus verziózás három számból álló alapformát használ. Ebben az 1.10.0 az 1.9.0 után áll a növekvő verziósorrendben, mert az első azonos rész után a tízet hasonlítjuk a kilenchez. A karakterek egyszerű szöveges rendezése ettől eltérő sorrendet eredményezhet.
Egy tetszőleges kiadó kéttagú 1.10 jelöléséről viszont nem állíthatjuk automatikusan, hogy ugyanennek a szabványnak felel meg. A kiadási dátum és a saját változatlista további támpont. Az újabb jelzőt csak az ellenőrzött sorrend alapján használd.
Négy mondat egy kitalált programról
- Az útmutató az 1.10 verzióhoz készült.
- A hibát a 2.4.1 verzióban javítottuk.
- A SemVer szerinti növekvő sorrendben az 1.9.0 előbb áll, mint az 1.10.0.
- A fájl neve megőrizte a kiadói jelölést: pelda-1.10.zip.
Az alábbi példák saját minták. Nem egy létező szoftver tényleges verzióit vagy frissítési sorrendjét ismertetik.
A mondat pontja külön szerepet kap
Ha a verzióazonosító a mondat végére kerül, utána mondatzáró pont állhat: A telepített változat száma 1.10. Másoláskor ezt a mondatpontot ne vedd át az azonosító részeként. Folyó szövegben a verzió szó hozzáadása gyakran világosabb határt ad.
Használható szerkesztési megoldás: Az 1.10 verzió van telepítve. Itt a pontozott jelölés a mondat belsejében áll. A megfogalmazás különösen akkor hasznos, ha az olvasónak kézzel kell megkeresnie vagy beírnia a változat számát.
Ugyanahhoz a változathoz ugyanaz a leírás tartozzon
Ellenőrizd a címet, a bevezetőt és a letöltési hivatkozás szövegét. Ha ezek három eltérő verziót neveznek meg, az olvasó nem tudja, melyikre vonatkozik az útmutató. Az egységesítés előtt tisztázd, melyik adat az aktuális.
Javítási példa: a kiadó jelölése 3.10.2, a cikkben 3,10,2 szerepel. Állítsd vissza a pontokat, majd az összes előfordulást ellenőrizd. A verzióazonosító pontos másolása adatmegőrzési feladat; a környező mondat nyelvi ellenőrzése ezután következhet.