Skip to content

update Brazilian Portuguese translation#384

Open
allima wants to merge 2 commits intosemver:gh-pagesfrom
allima:gh-pages
Open

update Brazilian Portuguese translation#384
allima wants to merge 2 commits intosemver:gh-pagesfrom
allima:gh-pages

Conversation

@allima
Copy link
Copy Markdown

@allima allima commented Sep 6, 2022

update Brazilian Portuguese translation

  • 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
- 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
@JohnTitor
Copy link
Copy Markdown
Member

This is for pt-BR translations, @apteles @walkeralencar could y'all review this? Thanks!

Comment thread lang/pt-BR/index.md
@@ -1,3 +1,4 @@

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is an unnecessary change, please drop.

@walkeralencar
Copy link
Copy Markdown
Contributor

This is for pt-BR translations, @apteles @walkeralencar could y'all review this? Thanks!

Hi @JohnTitor, I will review

@JohnTitor
Copy link
Copy Markdown
Member

Friendly-ping @walkeralencar, do you have time to review this?

Copy link
Copy Markdown
Contributor

@walkeralencar walkeralencar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have some issues to adjust.

Comment thread lang/pt-BR/index.md

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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Transmitem deve ser mantido, pois está se falando de numeros de versão e como eles mudam.

Comment thread lang/pt-BR/index.md
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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread lang/pt-BR/index.md
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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma regra do 2.

Comment thread lang/pt-BR/index.md
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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma regra do 2.

Comment thread lang/pt-BR/index.md
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 é
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma regra do 2.

Comment thread lang/pt-BR/index.md
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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma regra do 2.

Comment thread lang/pt-BR/index.md
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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma regra do 2.

Comment thread lang/pt-BR/index.md
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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma regra do 2.

Comment thread lang/pt-BR/index.md
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.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mesma regra do 2.

Comment thread lang/pt-BR/index.md

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).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment thread lang/pt-BR/index.md

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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Vírgula pode ser removida, para não interromper a compreensão da leitura.

Comment thread lang/pt-BR/spec/v2.0.0.md
@@ -1,3 +1,4 @@

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as Revisões aplicadas ao index.md tb se aplicam ao v2.0.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants