diff --git a/source/pt-BR/1.0.0/index.html.haml b/source/pt-BR/1.0.0/index.html.haml
index 274b946..d150966 100644
--- a/source/pt-BR/1.0.0/index.html.haml
+++ b/source/pt-BR/1.0.0/index.html.haml
@@ -177,136 +177,134 @@ version: 1.0.0
recomendado para as entradas do changelog.
%aside
- There’s more. Help me collect these antipatterns by
- = link_to "opening an issue", issues
- or a pull request.
+ Tem mais. Me ajude a colecionar essas más práticas
+ = link_to "enviando uma dúvida", issues
+ ou pedindo mudanças.
.frequently-asked-questions
%h3#frequently-asked-questions
%a.anchor{ href: "#frequently-asked-questions", aria_hidden: "true" }
- Frequently Asked Questions
+ Perguntas frequentes
%h4#standard
%a.anchor{ href: "#standard", aria_hidden: "true" }
- Is there a standard changelog format?
+ Existe um padrão para o formato do changelog?
%p
- Not really. There's the GNU changelog style guide, or the two-
- paragraph-long GNU NEWS file "guideline". Both are inadequate or
- insufficient.
+ Na verdade não. Existe o guia de estilo de changelog do
+ GNU ou o "guia" de dois parágrafos do GNU NEWS. Ambos são inadequados
+ ou insuficientes.
%p
- This project aims to be
- = link_to "a better changelog convention.", changelog
- It comes from observing good practices in the open source
- community and gathering them.
+ Este projeto pretende ser
+ = link_to "uma convenção de changelog melhor.", changelog
+ Ele vem de observar e coletar as boas práticas em código aberto da comunidade.
%p
- Healthy criticism, discussion and suggestions for improvements
- = link_to "are welcome.", issues
-
+ Críticas saudáveis, discussões e sugestões de melhorias
+ = link_to "são bem-vindas.", issues
%h4#filename
%a.anchor{ href: "#filename", aria_hidden: "true" }
- What should the changelog file be named?
+ Qual nome o arquivo changelog deve ter?
%p
- Call it CHANGELOG.md
. Some projects use
- HISTORY
, NEWS
or RELEASES
.
+ Chame-o CHANGELOG.md
. Alguns projetos usam
+ HISTORY
, NEWS
ou RELEASES
.
%p
- While it's easy to think that the name of your changelog file
- doesn't matter that much, why make it harder for your end users to
- consistently find notable changes?
+ Embora seja fácil pensar que o nome do seu arquivo changelog
+ não importa muito, por que tornar mais difícil para seus usuários
+ finais encontrarem consistentemente mudanças notáveis?
%h4#github-releases
%a.anchor{ href: "#github-releases", aria_hidden: "true" }
- What about GitHub Releases?
+ E sobre o GitHub Releases?
%p
- It's a great initiative. #{link_to "Releases", ghr} can be used to
- turn simple git tags (for example a tag named v1.0.0
)
- into rich release notes by manually adding release notes or it can
- pull annotated git tag messages and turn them into notes.
+ É uma grande iniciativa. #{link_to "Lançamentos", ghr} podem ser usados
+ para converter simples marcadores do git (por exemplo, um
+ marcador chamado v1.0.0
) em notas de versão ricas,
+ adicionando manualmente notas de versão ou pode puxar as mensagens
+ anotadas no marcador do git e transformá-las em notas.
%p
- GitHub Releases create a non-portable changelog that can only be
- displayed to users within the context of GitHub. It's possible to
- make them look very much like the Keep a Changelog format, but it
- tends to be a bit more involved.
+ GitHub Releases cria um changelog não portátil
+ que só pode ser exibido para usuários no contexto do GitHub.
+ É possível fazê-los parecer muito como o formato
+ Keep a Changelog, mas tende a estar um pouco mais envolvido.
%p
- The current version of GitHub releases is also arguably not very
- discoverable by end-users, unlike the typical uppercase files
- (README
, CONTRIBUTING
, etc.). Another
- minor issue is that the interface doesn't currently offer links to
- commit logs between each release.
+ A versão atual do GitHub Releases não são facilmente
+ por usuários finais, ao contrário dos arquivos maiúsculos típicos
+ (README
, CONTRIBUTING
, etc.). Outro
+ problema menor é que a interface atualmente não oferece links para
+ confirmar alterações entre cada lançamento.
%h4#automatic
%a.anchor{ href: "#automatic", aria_hidden: "true" }
- Can changelogs be automatically parsed?
+ Os changelogs podem ser criados automaticamente?
%p
- It’s difficult, because people follow wildly different formats and
- file names.
+ É difícil, porque as pessoas seguem formatos e nomes de arquivos
+ totalmente diferentes.
%p
- #{link_to "Vandamme", vandamme} is a Ruby gem created by the
- #{link_to "Gemnasium", gemnasium} team and which parses many (but
- not all) open source project changelogs.
-
+ #{link_to "Vandamme", vandamme} é um gem Ruby criado pelo
+ time #{link_to "Gemnasium", gemnasium} e que analisa muitas
+ (mas não todas) alterações de projetos de código aberto.
%h4#yanked
%a.anchor{ href: "#yanked", aria_hidden: "true" }
- What about yanked releases?
+ E o lançamentos removidos?
%p
- Yanked releases are versions that had to be pulled because of a
- serious bug or security issue. Often these versions don't even
- appear in change logs. They should. This is how you should display
- them:
+ Lançamentos removidos são versões que foram retiradas por causa de
+ problemas sérios ou falhas de segurança. Muitas vezes essas versões
+ nem aparecem no histórico de alterações. Eles deviam. É assim que
+ você deve exibi-los:
- %p ## 0.0.5 - 2014-12-13 [YANKED]
+ %p ## 0.0.5 - 2014-12-13 [REMOVIDO]
%p
- The [YANKED]
tag is loud for a reason. It's important
- for people to notice it. Since it's surrounded by brackets it's also
- easier to parse programmatically.
-
+ O marcador [REMOVIDO]
está em caixa alta por uma razão.
+ É importante que as pessoas o percebam. Uma vez que está entre
+ colchetes é fácil de ser analisado programaticamente.
%h4#rewrite
%a.anchor{ href: "#rewrite", aria_hidden: "true" }
- Should you ever rewrite a changelog?
+ Você deve reescrever um changelog?
%p
- Sure. There are always good reasons to improve a changelog. I
- regularly open pull requests to add missing releases to open source
- projects with unmaintained changelogs.
+ Claro. Sempre existe razão para melhorar um changelog. Eu
+ regularmente solicito uma alteração em projetos de código livre
+ para adicionar changelogs não mantidos.
%p
- It's also possible you may discover that you forgot to address a
- breaking change in the notes for a version. It's obviously important
- for you to update your changelog in this case.
-
+ Também é possível que você descubra que você esqueceu de abordar
+ uma mudança abrupta nas notas para uma versão.
+ Obviamente é importante para você atualizar seu changelog neste caso.
%h4#contribute
%a.anchor{ href: "#contribute", aria_hidden: "true" }
- How can I contribute?
+ Como eu posso ajudar?
%p
- This document is not the truth; it’s my carefully
- considered opinion, along with information and examples I gathered.
+ Esse documento não é uma verdade absoluta; É minha
+ opinião cuidadosamente considerada, juntamente com informações e
+ exemplos que eu reuni.
%p
- This is because I want our community to reach a consensus. I believe
- the discussion is as important as the end result.
+ Isso é porque eu quero que nossa comunidade chegue a um consenso.
+ Eu acredito que a discussão é tão importante quanto o resultado final.
%p
- So please #{link_to "pitch in", gh}.
+ Então, por favor #{link_to "contribua", gh}.
.press
- %h3 Conversations
+ %h3 Discussões
%p
- I went on #{link_to "The Changelog podcast", thechangelog}
- to talk about why maintainers and contributors should care about changelogs,
- and also about the motivations behind this project.
+ Eu fui em #{link_to "The Changelog podcast", thechangelog}
+ para falar sobre por que os mantenedores e contribuidores devem se
+ preocupar com os changelogs, e também sobre as motivações
+ por trás desse projeto.