2016-06-13 11 views
5

Questo è il contenuto alla barra laterale destra di GitHub:Perché GitHub suggerisce "prefisso i nomi delle versioni con la lettera v?"

suggerimenti Tagging E 'pratica comune prefisso i nomi di versione con la lettera v Alcuni nomi buoni tag potrebbero essere v1.0 o v2.3.4..

Se il tag non è destinato all'uso di produzione, aggiungere una versione preliminare dopo il nome della versione. Alcune buone versioni preliminari potrebbero essere v0.2-alpha o v5.9-beta.3.

Versioning semantico Se sei nuovo nel rilascio di software, ti consigliamo di leggere semantic versioning.

io non capisco perché prefisso vostri nomi di versione con la lettera V? Per favore, spiegami, perché i nomi delle versioni dei prefissi con la lettera v sono le best practice?

risposta

6

La maggior parte dei progetti open source e molti tag su github e altri siti VCS aperti seguono un formato chiamato Semantic Versioning, collegato anche nella citazione nella domanda. Questo è il modello delle versioni che suggerisce:

Dato un numero di versione Major.Minor.Patch, incrementare il:

  1. versione principale quando si apportano modifiche API incompatibili,
  2. versione minore quando si aggiungere funzionalità in un modo compatibile con le versioni precedenti e
  3. PATCH versione quando si apportano correzioni di errori compatibili con le versioni precedenti.

supplementari etichette per pre-release e costruire i metadati sono disponibili come estensioni al formato Major.Minor.Patch.

La raccomandazione SEMVER ha subito alcune revisioni a sé stanti, e ad un certo punto è stato consigliato preimpostare un tag con una "v", ma in questi giorni credo che non menzioni la pratica. Tuttavia, molti siti, progetti e convenzioni hanno seguito questa precedente pratica SEMVER e non si sono aggiornati per seguire i nuovi consigli.

La mia opinione è che probabilmente non importa se si avviano i tag con una "v" o meno. Ma potresti avere un tempo più semplice usando strumenti come sort se non lo fai.