update Brazilian Portuguese translation #384
Conversation
- adjustment in the numbering of item 11 - inclusion of an excerpt from Backus–Naur grammar - inclusion of questions in the FAQ and link to the semver regex example
- adjustment in the numbering of item 11 - inclusion of an excerpt from Backus–Naur grammar - inclusion of questions in the FAQ and link to the semver regex example
|
This is for pt-BR translations, @apteles @walkeralencar could y'all review this? Thanks! |
| @@ -1,3 +1,4 @@ | |||
|
|
|||
There was a problem hiding this comment.
This is an unnecessary change, please drop.
Hi @JohnTitor, I will review |
|
Friendly-ping @walkeralencar, do you have time to review this? |
| @@ -54,102 +55,168 @@ anteriores da API incrementa a versão Menor, e alterações incompatíveis com | |||
| versões anteriores da API incrementa a versão Maior. | |||
|
|
|||
| Eu chamo esse sistema de "Versionamento Semântico". Sob este esquema, os números | |||
| de versão e a forma como eles mudam transmitem o significado do código | |||
| de versão e a forma como eles mudam, transmite o significado do código | |||
There was a problem hiding this comment.
Transmitem deve ser mantido, pois está se falando de numeros de versão e como eles mudam.
| API poderá ser declarada no próprio código ou existir estritamente na | ||
| documentação, desde que seja precisa e compreensiva. | ||
|
|
||
| 2. Um número de versão normal DEVE ter o formato de X.Y.Z, onde X, Y, e Z são |
There was a problem hiding this comment.
Na documentação é utilizado sempre o 1. para caso seja incluido um paragrafo no meio, não seja necessário reescrever todos os demais numeros abaixo, sendo assim, a forma do 1. no markdown deve ser mantida, já que o mesmo é interpretado adequadamente e a numeração é sequenciada no modo de visualização.
| Y é a versão Menor, e Z é a versão de Correção. Cada elemento DEVE aumentar | ||
| numericamente. Por exemplo: 1.9.0 -> 1.10.0 -> 1.11.0. | ||
|
|
||
| 3. Uma vez que um pacote versionado foi lançado (released), o conteúdo desta |
| versão NÃO DEVE ser modificado. Qualquer modificação DEVE ser lançado como uma | ||
| nova versão. | ||
|
|
||
| 4. No início do desenvolvimento, a versão Maior DEVE ser zero (0.y.z). Qualquer |
| coisa PODE mudar a qualquer momento. A API pública NÃO DEVE ser considerada | ||
| estável. | ||
|
|
||
| 5. Versão 1.0.0 define a API como pública. A maneira como o número de versão é |
| Correção DEVE ser redefinida para 0 (zero) quando a versão Menor for | ||
| incrementada. | ||
|
|
||
| 8. Versão Maior X (X.y.z | X > 0) DEVE ser incrementada se forem introduzidas |
| Menor e de versão de Correção. Versão de Correção e Versão Menor DEVEM ser | ||
| redefinidas para 0 (zero) quando a versão Maior for incrementada. | ||
|
|
||
| 9. Uma versão de Pré-Lançamento (pre-release) PODE ser identificada adicionando |
| sua versão normal associada. Exemplos: 1.0.0-alpha, 1.0.0-alpha.1, 1.0.0-0.3.7, | ||
| 1.0.0-x.7.z.92. | ||
|
|
||
| 10. Metadados de construção (Build) DEVEM ser identificadas por adicionar um |
| apenas nos metadados de construção, têm a mesma precedência. Exemplos: | ||
| 1.0.0-alpha+001, 1.0.0+20130313144700, 1.0.0-beta+exp.sha.5114f85. | ||
|
|
||
| 11. A precedência refere-se a como as versões são comparadas entre si quando solicitadas. |
|
|
||
| 11. A precedência refere-se a como as versões são comparadas entre si quando solicitadas. | ||
|
|
||
| 1. A precedência DEVE ser calculada separando a versão em identificadores Maior (major), Menor(minor), Correção (patch) e de pré-lançamento nessa ordem (os metadados de compilação não têm precedência). |
There was a problem hiding this comment.
As linhas foram definidas com largura máxima de 80 caracteres.
Ex.: https://raw.githubusercontent.com/semver/semver.org/gh-pages/index.md
ps.: eu tb nao gosto, mas foi o padrao definido
| @@ -40,8 +41,8 @@ em frente com seu projeto de maneira fácil e segura. | |||
| Como uma solução para este problema proponho um conjunto simples de regras e | |||
| requisitos que ditam como os números das versões são atribuídos e incrementados. | |||
|
|
|||
| Essas regras são baseadas em, mas não necessariamente limitadas às, bem | |||
| difundidas práticas comumente em uso tanto em softwares fechados como | |||
| Essas regras são baseadas em, mas não necessariamente limitadas às, bem | |||
There was a problem hiding this comment.
Vírgula pode ser removida, para não interromper a compreensão da leitura.
| @@ -1,3 +1,4 @@ | |||
|
|
|||
There was a problem hiding this comment.
as Revisões aplicadas ao index.md tb se aplicam ao v2.0.0
update Brazilian Portuguese translation