mirror of
https://github.com/olivierlacan/keep-a-changelog.git
synced 2025-07-28 16:24:07 +02:00
Merge branch 'master' into link-usernames-in-changelog
This commit is contained in:
Olivier Lacan
GitHub
commit
4889309614
10
CHANGELOG.md
10
CHANGELOG.md
@ -1,8 +1,8 @@
|
||||
# Changelog
|
||||
All notable changes to this project will be documented in this file.
|
||||
|
||||
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
|
||||
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
@ -22,7 +22,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
|
||||
- Swedish translation from [@magol](https://github.com/magol).
|
||||
- Turkish translation from [@karalamalar](https://github.com/karalamalar).
|
||||
- French translation from [@zapashcanon](https://github.com/zapashcanon).
|
||||
- Brazilian Portugese translation from [@aisamu](https://github.com/aisamu).
|
||||
- Brazilian Portugese translation from [@Webysther](https://github.com/Webysther).
|
||||
- Polish translation from [@amielucha](https://github.com/amielucha).
|
||||
- Russian translation from [@aishek](https://github.com/aishek).
|
||||
- Czech translation from [@h4vry](https://github.com/h4vry).
|
||||
@ -41,7 +41,7 @@ translation authors keep things up-to-date.
|
||||
- Merge "Why can’t people just use a git log diff?" with "Commit log
|
||||
diffs"
|
||||
- Fix typos in Simplified Chinese and Traditional Chinese translations.
|
||||
- Fix typos in Brazilian Portugese translation.
|
||||
- Fix typos in Brazilian Portuguese translation.
|
||||
- Fix typos in Turkish translation.
|
||||
- Fix typos in Czech translation.
|
||||
- Fix typos in Swedish translation.
|
||||
@ -68,7 +68,7 @@ benefit both "open" and "closed" source projects equally.
|
||||
|
||||
### Changed
|
||||
- Improve argument against commit logs.
|
||||
- Start following [SemVer](http://semver.org) properly.
|
||||
- Start following [SemVer](https://semver.org) properly.
|
||||
|
||||
## [0.0.8] - 2015-02-17
|
||||
### Changed
|
||||
|
||||
@ -40,7 +40,7 @@ Project maintainers who do not follow or enforce the Code of Conduct in good fai
|
||||
|
||||
## Attribution
|
||||
|
||||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
|
||||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [https://contributor-covenant.org/version/1/4][version]
|
||||
|
||||
[homepage]: http://contributor-covenant.org
|
||||
[version]: http://contributor-covenant.org/version/1/4/
|
||||
[homepage]: https://contributor-covenant.org
|
||||
[version]: https://contributor-covenant.org/version/1/4/
|
||||
|
||||
@ -4,7 +4,7 @@
|
||||
|
||||
Don’t let your friends dump git logs into changelogs™
|
||||
|
||||
This repository generates http://keepachangelog.com/.
|
||||
This repository generates https://keepachangelog.com/.
|
||||
|
||||
## Development
|
||||
### Dependencies
|
||||
@ -39,6 +39,10 @@ few native speakers of the language you're translating to in the Pull Request
|
||||
comments. They'll help review your translation for simple mistakes and give us
|
||||
a better idea of whether your translation is accurate.
|
||||
|
||||
## Contribute
|
||||
|
||||
Please do contribute! Issues and pull requests are welcome.
|
||||
|
||||
Thank you for your help improving software one changelog at a time!
|
||||
|
||||
[CHANGELOG]: ./CHANGELOG.md
|
||||
|
||||
@ -53,7 +53,7 @@ $languages = {
|
||||
name: "Nederlands"
|
||||
},
|
||||
"pl" => {
|
||||
name: "Polskie"
|
||||
name: "polski"
|
||||
},
|
||||
"pt-BR" => {
|
||||
name: "Português do Brasil",
|
||||
@ -101,7 +101,7 @@ activate :i18n,
|
||||
|
||||
set :gauges_id, ''
|
||||
set :publisher_url, 'https://www.facebook.com/olivier.lacan.5'
|
||||
set :site_url, 'http://keepachangelog.com'
|
||||
set :site_url, 'https://keepachangelog.com'
|
||||
|
||||
redirect "index.html", to: "en/#{$last_version}/index.html"
|
||||
|
||||
|
||||
@ -41,7 +41,7 @@ version: 0.3.0
|
||||
- Dá se v něm jednoduše odkázat na libovolnou sekci (proto raději Markdown než plain text).
|
||||
- Jedna pod-sekce za verzi.
|
||||
- Seznam vydání ve zpětně-chronologickém pořadí (nejnovější navrchu).
|
||||
- Psaní všech dat ve formátu `RRRR-MM-DD`. (Příklad: `2012-06-02` pro `2. červen 2012`.) Je to mezinárodní, [rozumné](http://xkcd.com/1179/) a nezávislé na jazyce.
|
||||
- Psaní všech dat ve formátu `RRRR-MM-DD`. (Příklad: `2012-06-02` pro `2. červen 2012`.) Je to mezinárodní, [rozumné](https://xkcd.com/1179/) a nezávislé na jazyce.
|
||||
- Explicitní uvedení toho, zda projekt dodržuje [Semantické Verzování][semver].
|
||||
- Každá verze by měla:
|
||||
- Uvádět datum vydání ve výše uvedeném formátu.
|
||||
@ -170,7 +170,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -41,7 +41,7 @@ version: 0.3.0
|
||||
- Es ist einfach, jeden Bereich zu verlinken (also besser Markdown als einfacher Text).
|
||||
- Ein Unterkapitel pro Version.
|
||||
- Liste die Releases in umgekehrt chronologischer Reihenfolge auf (neuestes zuoberst).
|
||||
- Schreib alle Daten im Format `JJJJ-MM-TT`. (Beispiel: `2012-06-02` für den `2. Juni 2012`.) Es ist international, [vernünftig](http://xkcd.com/1179/), und sprachunabhängig.
|
||||
- Schreib alle Daten im Format `JJJJ-MM-TT`. (Beispiel: `2012-06-02` für den `2. Juni 2012`.) Es ist international, [vernünftig](https://xkcd.com/1179/), und sprachunabhängig.
|
||||
- Erwähne explizit, ob das Projekt nach [Semantic Versioning][semver] geführt wird.
|
||||
- Jede Version sollte:
|
||||
- Das Release-Datum im oben genannten Format auflisten.
|
||||
@ -177,7 +177,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -41,7 +41,7 @@ version: 0.3.0
|
||||
- Easy to link to any section (hence Markdown over plain text).
|
||||
- One sub-section per version.
|
||||
- List releases in reverse-chronological order (newest on top).
|
||||
- Write all dates in `YYYY-MM-DD` format. (Example: `2012-06-02` for `June 2nd, 2012`.) It’s international, [sensible](http://xkcd.com/1179/), and language-independent.
|
||||
- Write all dates in `YYYY-MM-DD` format. (Example: `2012-06-02` for `June 2nd, 2012`.) It’s international, [sensible](https://xkcd.com/1179/), and language-independent.
|
||||
- Explicitly mention whether the project follows [Semantic Versioning][semver].
|
||||
- Each version should:
|
||||
- List its release date in the above format.
|
||||
@ -176,7 +176,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,12 +9,14 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
- ghr = "https://help.github.com/articles/creating-releases/"
|
||||
- gnustyle = "https://www.gnu.org/prep/standards/html_node/Style-of-Change-Logs.html#Style-of-Change-Logs"
|
||||
- gnunews = "https://www.gnu.org/prep/standards/html_node/NEWS-File.html#NEWS-File"
|
||||
|
||||
.header
|
||||
.title
|
||||
@ -193,9 +195,9 @@ version: 1.0.0
|
||||
Is there a standard changelog format?
|
||||
|
||||
%p
|
||||
Not really. There's the GNU changelog style guide, or the two-
|
||||
paragraph-long GNU NEWS file "guideline". Both are inadequate or
|
||||
insufficient.
|
||||
Not really. There's the #{link_to "GNU changelog style guide",
|
||||
gnustyle}, or the #{link_to "two-paragraph-long GNU NEWS file", gnunews}
|
||||
"guideline". Both are inadequate or insufficient.
|
||||
|
||||
%p
|
||||
This project aims to be
|
||||
|
||||
@ -39,7 +39,7 @@ version: 0.3.0
|
||||
- Fácil de conectar a cualquier sección (de ahí a que se use Markdown sobre texto plano).
|
||||
- Una sub-sección por versión.
|
||||
- Lista los releases en un orden inversamente-cronológico (el más reciente en la parte superior).
|
||||
- Escribe todas las fechas en formato `AAAA-MM-DD`. (Ejemplo: `2012-06-02` en vez de `2 JUN 2012`.) Es internacional, [sensible](http://xkcd.com/1179/), e independientemente del lenguaje que usemos.
|
||||
- Escribe todas las fechas en formato `AAAA-MM-DD`. (Ejemplo: `2012-06-02` en vez de `2 JUN 2012`.) Es internacional, [sensible](https://xkcd.com/1179/), e independientemente del lenguaje que usemos.
|
||||
- Se menciona explícitamente si el proyecto sigue la convención del [Versionamiento Semántico][semver].
|
||||
- Cada versión debería:
|
||||
- Indicar su fecha de lanzamiento en el formato anterior.
|
||||
@ -134,7 +134,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -49,7 +49,7 @@ version: 0.3.0
|
||||
- Liste les publications dans l’ordre chronologique inverse (les plus récentes
|
||||
en haut).
|
||||
- Toutes les dates sont au format `AAAA-MM-JJ`. (Exemple: `2012-06-02` pour le
|
||||
`2 Juin 2012`.) C’est international, [raisonnable](http://xkcd.com/1179/) et
|
||||
`2 Juin 2012`.) C’est international, [raisonnable](https://xkcd.com/1179/) et
|
||||
indépendant de la langue.
|
||||
- Mentionne explicitement si le projet respecte le
|
||||
[Versionnage Sémantique][semver].
|
||||
@ -203,7 +203,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -42,7 +42,7 @@ version: 0.3.0
|
||||
- Easy to link to any section (hence Markdown over plain text).
|
||||
- One sub-section per version.
|
||||
- List releases in reverse-chronological order (newest on top).
|
||||
- Write all dates in `YYYY-MM-DD` format. (Example: `2012-06-02` for `June 2nd, 2012`.) It’s international, [sensible](http://xkcd.com/1179/), and language-independent.
|
||||
- Write all dates in `YYYY-MM-DD` format. (Example: `2012-06-02` for `June 2nd, 2012`.) It’s international, [sensible](https://xkcd.com/1179/), and language-independent.
|
||||
- Explicitly mention whether the project follows [Semantic Versioning][semver].
|
||||
- Each version should:
|
||||
- List its release date in the above format.
|
||||
@ -177,7 +177,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -39,7 +39,7 @@ language: it-IT
|
||||
- Facile da linkare ad altre sezioni (da cui il Markdown invece che testo normale).
|
||||
- Una sotto-sezione per ogni versione.
|
||||
- Elenca le release in ordine cronologico inverso (quelle più recenti all'inizio).
|
||||
- Scrive tutte le date nel formato `YYYY-MM-DD`. (Esempio: `2012-06-02` sta per `2 Giugno 2012`). È internazionale, [sensato](http://xkcd.com/1179/), e indipendente dalla lingua.
|
||||
- Scrive tutte le date nel formato `YYYY-MM-DD`. (Esempio: `2012-06-02` sta per `2 Giugno 2012`). È internazionale, [sensato](https://xkcd.com/1179/), e indipendente dalla lingua.
|
||||
- Dichiara esplicitamente se il progetto segue il [Semantic Versioning][semver].
|
||||
- Ogni versione dovrebbe:
|
||||
- Elencare la sua data di rilascio nel formato sopra specificato.
|
||||
@ -169,7 +169,7 @@ language: it-IT
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
@ -50,7 +50,7 @@ version: 1.0.0
|
||||
|
||||
%p
|
||||
Le persone ne hanno bisogno. Che si tratti di consumatori o di sviluppatori, gli utenti finali
|
||||
del software sono persone interessate a ciò che avviene in esso.
|
||||
sono persone interessate a ciò che avviene in esso.
|
||||
Se il software è cambiato, allora le persone vogliono sapere come e perché.
|
||||
|
||||
.good-practices
|
||||
@ -64,11 +64,11 @@ version: 1.0.0
|
||||
|
||||
%ul
|
||||
%li
|
||||
I Changelogs sono <em>per le persone</em>, non per le macchine.
|
||||
I changelog sono <em>per le persone</em>, non per le macchine.
|
||||
%li
|
||||
Dovrebbe essere una voce per ogni singola versione.
|
||||
Dovrebbe esserci una voce per ogni singola versione.
|
||||
%li
|
||||
Gli stessi tipi di modifiche dovrebbero essere raggruppati.
|
||||
Le modifiche dello stesso tipo dovrebbero essere raggruppate.
|
||||
%li
|
||||
Versioni e sezioni dovrebbero essere collegabili.
|
||||
%li
|
||||
@ -93,7 +93,7 @@ version: 1.0.0
|
||||
per le funzionalità che saranno rimosse nelle future release.
|
||||
%li
|
||||
%code Removed
|
||||
per funzionalità deprecate rimosse in questa release.
|
||||
per funzionalità rimosse in questa release.
|
||||
%li
|
||||
%code Fixed
|
||||
per tutti i bug fix.
|
||||
@ -133,7 +133,7 @@ version: 1.0.0
|
||||
|
||||
%p
|
||||
Usare i commit log diffs al posto dei changelog è una brutta idea: contengono solo cose superflue.
|
||||
Come come i merge commits, i commits con titoli oscuri,
|
||||
Cose come i merge commits, i commits con titoli oscuri,
|
||||
le modifiche della documentazione, etc.
|
||||
|
||||
%p
|
||||
@ -146,13 +146,13 @@ version: 1.0.0
|
||||
|
||||
%h4#ignoring-deprecations
|
||||
%a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" }
|
||||
Ignorare le Deprecazioni
|
||||
Ignorare le deprecazioni
|
||||
%p
|
||||
Quando le persone aggiornano da una versione ad un'altra,
|
||||
dovrebbe essere dolorosamente chiaro che qualcosa si romperà.
|
||||
Dovrebbe essere possibile eseguire l'aggiornamento a una versione
|
||||
che elenca le deprecazioni, rimuove ciò che è deprecato, quindi
|
||||
aggiorna alla versione in cui le deprecazioni diventano rimozioni.
|
||||
che elenca le deprecazioni, rimuovere ciò che è deprecato, quindi
|
||||
aggiornare alla versione in cui le deprecazioni diventano rimozioni.
|
||||
%p
|
||||
Se non fai nient'altro elenca le deprecazioni, le rimozioni e
|
||||
qualsiasi altro cambiamento nel tuo changelog.
|
||||
@ -210,8 +210,8 @@ version: 1.0.0
|
||||
<code>HISTORY</code>, <code>NEWS</code> o <code>RELEASES</code>.
|
||||
|
||||
%p
|
||||
Mentre è facile pensare che il nome del tuo file changelog
|
||||
non sia poi così importante, perchè non rendere facile la
|
||||
Risulta facile pensare che il nome del tuo file changelog
|
||||
non sia poi così importante, allora perchè non rendere facile la
|
||||
vita ai tuoi utenti, usando sempre lo stesso nome?
|
||||
|
||||
%h4#github-releases
|
||||
@ -305,6 +305,6 @@ version: 1.0.0
|
||||
.press
|
||||
%h3 Dialogo
|
||||
%p
|
||||
Sono andato su #{link_to "The Changelog podcast", thechangelog}
|
||||
Sono andato a #{link_to "The Changelog podcast", thechangelog}
|
||||
per parlare del perché i gestori e i contributori dovrebbero preoccuparsi dei changelog
|
||||
e anche delle motivazioni dietro questo progetto.
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -37,7 +37,7 @@ version: 0.3.0
|
||||
- Prostota dodawania linków do każdego rozdziału (dlatego używa się Markdown zamiast prostego tekstu).
|
||||
- Jeden podrozdział dla każdej wersji.
|
||||
- Wyszczególniaj wydania w odwrotnym porządku chronologicznym (najnowsza na górze).
|
||||
- Wszystkie daty zapisuj w formacie `YYYY-MM-DD`. (Przykład: `2012-06-02` dla `2 czerwca 2012 r.`). To [rozsądny](http://xkcd.com/1179/), niezależny od języka międzynarodowy format.
|
||||
- Wszystkie daty zapisuj w formacie `YYYY-MM-DD`. (Przykład: `2012-06-02` dla `2 czerwca 2012 r.`). To [rozsądny](https://xkcd.com/1179/), niezależny od języka międzynarodowy format.
|
||||
- Zawsze określaj, czy projekt jest zgodny z [Semantycznym Wersjonowaniem][semver].
|
||||
- Każda wersja powinna:
|
||||
- Zawierać datę w wyżej wymienionym formacie.
|
||||
@ -138,7 +138,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
@ -230,7 +230,7 @@ version: 1.0.0
|
||||
%p
|
||||
Bieżąca wersja wydań GitHub jest też prawdopodobnie nie najłatwiejsza do
|
||||
odnalezienia dla użytkowników końcowych, w przeciwieństwie do plików
|
||||
o nazwach z wielkimi literami (<code>README</code>, <code>CONTRIBUTING<code>
|
||||
o nazwach z wielkimi literami (<code>README</code>, <code>CONTRIBUTING</code>
|
||||
itp.). Innym mniejszym brakiem jest to, że interfejs obecnie nie posiada
|
||||
linków do logów commitów pomiędzy każdymi wydaniami.
|
||||
|
||||
|
||||
@ -50,7 +50,7 @@ version: 0.3.0
|
||||
- Lista as versões publicadas em ordem cronológica decrescente (mais novo em
|
||||
cima).
|
||||
- Usa todas as datas no formato `AAAA-MM-DD`. (Exemplo: `2012-06-02` para
|
||||
`2 de Junho de 2012`.) É internacional, [sensato](http://xkcd.com/1179/), e
|
||||
`2 de Junho de 2012`.) É internacional, [sensato](https://xkcd.com/1179/), e
|
||||
independente de língua.
|
||||
- Menciona explicitamente se o projeto segue o [Versionamento Semântico][semver].
|
||||
- Cada versão deve:
|
||||
@ -200,7 +200,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -51,7 +51,7 @@ version: 0.3.0
|
||||
- Релизы перечислены в обратном хронологическом порядке (самые новые –
|
||||
сверху).
|
||||
- Пишите все даты в формате `YYYY-MM-DD`. (Например: `2012-06-02` для даты `2
|
||||
июня 2012`.) Он международный, [рациональный](http://xkcd.com/1179/), и
|
||||
июня 2012`.) Он международный, [рациональный](https://xkcd.com/1179/), и
|
||||
независим от языка.
|
||||
- Ясно указывает, использует ли проект [Семантическое
|
||||
Версионирование][semver].
|
||||
@ -206,7 +206,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
@ -218,7 +218,7 @@ version: 1.0.0
|
||||
|
||||
%p
|
||||
Это отличная инициатива. #{link_to "Релизы", ghr} могут использоваться
|
||||
для превращения простых тегов в Git (наприме тег <code>v1.0.0</code>)
|
||||
для превращения простых тегов в Git (например, тег <code>v1.0.0</code>)
|
||||
в подробные заметки к релизам с помощью их редактирования вручную,
|
||||
или с помощью комментариев к таким тегам.
|
||||
|
||||
@ -230,8 +230,8 @@ version: 1.0.0
|
||||
|
||||
%p
|
||||
Текущая версия Релизов на Гитхабе также возможно не так хорошо видна
|
||||
для конечных пользователей, в отличии от обычных файлов с именами в верхнем
|
||||
регистре (<code>README</code>, <code>CONTRIBUTING</code>, и так далее).
|
||||
для конечных пользователей, в отличие от обычных файлов с именами в верхнем
|
||||
регистре (<code>README</code>, <code>CONTRIBUTING</code> и так далее).
|
||||
Другая небольшая проблема заключается в том, что интерфейс не предлагает
|
||||
ссылок на логи коммитов между релизами.
|
||||
|
||||
@ -262,7 +262,7 @@ version: 1.0.0
|
||||
|
||||
%p
|
||||
Тег <code>[YANKED]</code> так бросается в глаза специально. Очень важно,
|
||||
чтобы люди его заметели. Так как он обрамлён квадратными скобками,
|
||||
чтобы люди его заметили. Так как он обрамлён квадратными скобками,
|
||||
его также проще распарсить программно.
|
||||
|
||||
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -41,7 +41,7 @@ version: 0.3.0
|
||||
- Enostaven za povezavo kateri koli sekciji (torej Markdown pred golim besedilom).
|
||||
- Ena pod-sekcija na verzijo.
|
||||
- Seznam izdaj v obratnem kronološkem vrstnem redu (najnovejše na vrhu).
|
||||
- Zapis vseh datumov v `YYYY-MM-DD` formatu. (Na primer: `2012-06-02` za `2. junij 2012`.) Je mednarnodno, [smiselno](http://xkcd.com/1179/) in neodvisno od jezika.
|
||||
- Zapis vseh datumov v `YYYY-MM-DD` formatu. (Na primer: `2012-06-02` za `2. junij 2012`.) Je mednarnodno, [smiselno](https://xkcd.com/1179/) in neodvisno od jezika.
|
||||
- Eksplicitna omemba ali projekt sledi [semantičnim verzijam][semver].
|
||||
- Vsaka verzija bi morala:
|
||||
- Imeti seznam njenih datumov izdaje v zgornjem formatu.
|
||||
@ -176,7 +176,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -43,7 +43,7 @@ version: 0.3.0
|
||||
- Listar utgåvor i omvänd kronologisk ordning (nyast högst upp).
|
||||
- Anger alla datum på formatet `YYYY-MM-DD`
|
||||
(exempel: `2012-06-02` för 2:a juni 2012). Det är internationellt,
|
||||
[förnuftigt](http://xkcd.com/1179/) och språkoberoende.
|
||||
[förnuftigt](https://xkcd.com/1179/) och språkoberoende.
|
||||
- Anger uttryckligen om projektet följer [Semantisk versionshantering][SemVer].
|
||||
- Varje version bör:
|
||||
- Ange datum då utgåvan släpptes på formatet angivet ovan.
|
||||
@ -180,7 +180,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
@ -254,12 +254,13 @@ version: 1.0.0
|
||||
|
||||
%h4#yanked
|
||||
%a.anchor{ href: "#yanked", aria_hidden: "true" }
|
||||
Hur är det med brådskande utgåvor ("yanked")?
|
||||
Hur är det med återtagna utgåvor ("yanked")?
|
||||
|
||||
%p
|
||||
Brådskande utgåvor är versioner som måste släppas på grund av alvarliga
|
||||
buggar eller säkerhetsproblem. Oftast brukar dessa versioner inte ens
|
||||
finnas med i ändringsloggarna. De borde det. Så här borde du visa dem:
|
||||
Återtagna utgåvor är versioner som måste tas tillbaka på grund av
|
||||
allvarliga buggar eller säkerhetsproblem. Oftast brukar dessa versioner
|
||||
inte ens finnas med i ändringsloggarna. De borde det. Så här borde du
|
||||
visa dem:
|
||||
|
||||
%p <code>## 0.0.5 - 2014-12-13 [YANKED]</code>
|
||||
|
||||
|
||||
@ -39,7 +39,7 @@ version: 0.3.0
|
||||
- Kolayca bölümler arası bağlantı kurulabilmelidir. (Bu yüzden yalın metin yerine markdown)
|
||||
- Her sürüm için bir alt bölüm içermelidir.
|
||||
- Dağıtımları tersine tarih sırası ile listemelidir. (En yeni en üstte)
|
||||
- Tüm tarihler `YYYY-AA-GG` biçiminde olmalıdır. (Örneğin `2 Haziran 2012` için `2012-06-02`) Uluslararasıdır, [anlamlıdır](http://xkcd.com/1179/), ve lisan bağımsızdır.
|
||||
- Tüm tarihler `YYYY-AA-GG` biçiminde olmalıdır. (Örneğin `2 Haziran 2012` için `2012-06-02`) Uluslararasıdır, [anlamlıdır](https://xkcd.com/1179/), ve lisan bağımsızdır.
|
||||
- [Anlamsal sürümleme][semver]nin desteklenip desteklenmediğini özellikle belirtilmelidir.
|
||||
- Her sürümde olması gerekenler:
|
||||
- Üstteki biçimde dağıtım tarihi.
|
||||
@ -171,7 +171,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -40,7 +40,7 @@ version: 0.3.0
|
||||
- 一个版本对应一个章节。
|
||||
- 最新的版本在上，最老的在下面。
|
||||
- 所有日期采用'YYYY-MM-DD'这种规范。（例如北京奥运会的2008年8月8日是2008-08-08）这个是国际通用，任何语言
|
||||
都能理解的，并且还被[xkcd](http://xkcd.com/1179/)推荐呢！
|
||||
都能理解的，并且还被[xkcd](https://xkcd.com/1179/)推荐呢！
|
||||
- 标出来是否遵守[语义化版本格式][semver]
|
||||
- 每一个软件的版本必须：
|
||||
- 标明日期（要用上面说过的规范）
|
||||
@ -141,7 +141,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/lang/zh-CN/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/lang/zh-CN/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme/
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
@ -40,7 +40,7 @@ version: 0.3.0
|
||||
- 一個版本對應一個章節。
|
||||
- 最新的版本在上面，最舊的在下面。
|
||||
- 所有日期採用 'YYYY-MM-DD' 這種規範。（例如北京奧運會的 2008 年 8 月 8 日是 2008-08-08）這個是國際通用，任何語言
|
||||
都能理解的，並且還被 [xkcd](http://xkcd.com/1179/) 推薦呢！
|
||||
都能理解的，並且還被 [xkcd](https://xkcd.com/1179/) 推薦呢！
|
||||
- 標出來是否遵守[語義化版本格式][semver]
|
||||
- 每一個軟體的版本必須：
|
||||
- 標明日期（要用上面說過的規範）
|
||||
@ -141,7 +141,7 @@ version: 0.3.0
|
||||
[gemnasium]: https://gemnasium.com/
|
||||
[gh]: https://github.com/olivierlacan/keep-a-changelog
|
||||
[issues]: https://github.com/olivierlacan/keep-a-changelog/issues
|
||||
[semver]: http://semver.org/lang/zh-CN/
|
||||
[shields]: http://shields.io/
|
||||
[semver]: https://semver.org/lang/zh-CN/
|
||||
[shields]: https://shields.io/
|
||||
[thechangelog]: http://5by5.tv/changelog/127
|
||||
[vandamme]: https://github.com/tech-angels/vandamme
|
||||
|
||||
@ -9,8 +9,8 @@ version: 1.0.0
|
||||
- gemnasium = "https://gemnasium.com/"
|
||||
- gh = "https://github.com/olivierlacan/keep-a-changelog"
|
||||
- issues = "https://github.com/olivierlacan/keep-a-changelog/issues"
|
||||
- semver = "http://semver.org/lang/zh-TW/"
|
||||
- shields = "http://shields.io/"
|
||||
- semver = "https://semver.org/lang/zh-TW/"
|
||||
- shields = "https://shields.io/"
|
||||
- thechangelog = "http://5by5.tv/changelog/127"
|
||||
- vandamme = "https://github.com/tech-angels/vandamme/"
|
||||
- iso = "http://www.iso.org/iso/home/standards/iso8601.htm"
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user