Fix illegal nesting

This commit is contained in:
Olivier Lacan 2017-10-17 14:21:12 -04:00
parent b7ff089dfb
commit ba2d594f31

View File

@ -152,13 +152,13 @@ version: 1.0.0
Ignorando depreciações Ignorando depreciações
%p %p
Quando pessoas atualizam de uma versão para outra, deve ficar muitíssimo claro Quando pessoas atualizam de uma versão para outra, deve ficar muitíssimo claro
quando algo vai quebrar. Deve ser possível atualizar para uma versão quando algo vai quebrar. Deve ser possível atualizar para uma versão
com depreciações listadas, remova o que é obsoleto, depois atualize com depreciações listadas, remova o que é obsoleto, depois atualize
para a versão onde as depreciações se tornam remoções. para a versão onde as depreciações se tornam remoções.
%p %p
Se você não fizer mais nada, liste no seu <em>changelog</em> as depreciações, Se você não fizer mais nada, liste no seu <em>changelog</em> as depreciações,
remoções e quaisquer mudanças que gerem falhas. remoções e quaisquer mudanças que gerem falhas.
%h4#confusing-dates %h4#confusing-dates
@ -172,7 +172,7 @@ version: 1.0.0
a ordem da maior para a menor unidade de tempo: ano, mês e dia. Este formato a ordem da maior para a menor unidade de tempo: ano, mês e dia. Este formato
também não se confunde de maneira ambígua com outros formatos de data, ao também não se confunde de maneira ambígua com outros formatos de data, ao
contrário de alguns formatos regionais que alteram a posição dos números do mês contrário de alguns formatos regionais que alteram a posição dos números do mês
e dia. Esses motivos, e o fato de ser um formato de data suportado pela e dia. Esses motivos, e o fato de ser um formato de data suportado pela
#{link_to "norma ISO", iso} são as razões para ele ser o formato de data #{link_to "norma ISO", iso} são as razões para ele ser o formato de data
recomendado para as entradas do <em>changelog</em>. recomendado para as entradas do <em>changelog</em>.
@ -191,14 +191,14 @@ version: 1.0.0
Existe um padrão para o formato do <em>changelog</em>? Existe um padrão para o formato do <em>changelog</em>?
%p %p
Na verdade não. Existe o guia de estilo de <em>changelog</em> do Na verdade não. Existe o guia de estilo de <em>changelog</em> do GNU
GNU ou o "guia" de dois parágrafos do GNU NEWS. Ambos são inadequados ou o "guia" de dois parágrafos do GNU NEWS. Ambos são inadequados ou
ou insuficientes. insuficientes.
%p %p
Este projeto pretende ser Este projeto pretende ser #{link_to "uma convenção de <em>changelog</em> melhor.", changelog}
    = link_to "uma convenção de <em>changelog</em> melhor.", changelog Ele vem de observar e coletar as boas práticas em código aberto da
    Ele vem de observar e coletar as boas práticas em código aberto da comunidade. comunidade.
%p %p
Críticas saudáveis, discussões e sugestões de melhorias Críticas saudáveis, discussões e sugestões de melhorias
@ -214,7 +214,7 @@ version: 1.0.0
%p %p
Embora seja fácil pensar que o nome do seu arquivo <em>changelog</em> Embora seja fácil pensar que o nome do seu arquivo <em>changelog</em>
não importa muito, por que tornar mais difícil para seus usuários não importa muito, por que tornar mais difícil para seus usuários
finais encontrarem consistentemente mudanças notáveis? finais encontrarem consistentemente mudanças notáveis?
%h4#github-releases %h4#github-releases
@ -222,23 +222,23 @@ version: 1.0.0
E sobre o <em>GitHub Releases</em>? E sobre o <em>GitHub Releases</em>?
%p %p
É uma grande iniciativa. #{link_to "Lançamentos", ghr} podem ser usados É uma grande iniciativa. #{link_to "Lançamentos", ghr} podem ser usados
para converter simples marcadores do <em>git</em> (por exemplo, um para converter simples marcadores do <em>git</em> (por exemplo, um
marcador chamado <code>v1.0.0</code>) em notas de versão ricas, marcador chamado <code>v1.0.0</code>) em notas de versão ricas,
adicionando manualmente notas de versão ou pode puxar as mensagens adicionando manualmente notas de versão ou pode puxar as mensagens
anotadas no marcador do <em>git</em> e transformá-las em notas. anotadas no marcador do <em>git</em> e transformá-las em notas.
%p %p
<em>GitHub Releases</em> cria um <em>changelog</em> não portátil <em>GitHub Releases</em> cria um <em>changelog</em> não portátil
que só pode ser exibido para usuários no contexto do GitHub. que só pode ser exibido para usuários no contexto do GitHub.
É possível fazê-los parecer muito como o formato É possível fazê-los parecer muito como o formato
<em>Keep a Changelog</em>, mas tende a ser um pouco mais complicado. <em>Keep a Changelog</em>, mas tende a ser um pouco mais complicado.
%p %p
A versão atual do <em>GitHub Releases</em> não é facilmente descoberta A versão atual do <em>GitHub Releases</em> não é facilmente descoberta
por usuários finais, ao contrário dos arquivos maiúsculos típicos por usuários finais, ao contrário dos arquivos maiúsculos típicos
(<code>README</code>, <code>CONTRIBUTING</code>, etc.). Outro (<code>README</code>, <code>CONTRIBUTING</code>, etc.). Outro
problema de menor magnitude é que a interface atualmente não oferece problema de menor magnitude é que a interface atualmente não oferece
links para confirmar alterações entre cada lançamento. links para confirmar alterações entre cada lançamento.
%h4#automatic %h4#automatic
@ -246,12 +246,12 @@ version: 1.0.0
Os <em>changelogs</em> podem ser criados automaticamente? Os <em>changelogs</em> podem ser criados automaticamente?
%p %p
É difícil, porque as pessoas seguem formatos e nomes de arquivos É difícil, porque as pessoas seguem formatos e nomes de arquivos
totalmente diferentes. totalmente diferentes.
%p %p
#{link_to "Vandamme", vandamme} é um <em>gem Ruby</em> criado pelo #{link_to "Vandamme", vandamme} é um <em>gem Ruby</em> criado pelo
time #{link_to "Gemnasium", gemnasium} e que analisa muitas time #{link_to "Gemnasium", gemnasium} e que analisa muitas
(mas não todas) alterações de projetos de código aberto. (mas não todas) alterações de projetos de código aberto.
%h4#yanked %h4#yanked
@ -277,13 +277,13 @@ version: 1.0.0
%p %p
Claro. Sempre existe razão para melhorar um <em>changelog</em>. Claro. Sempre existe razão para melhorar um <em>changelog</em>.
Eu regularmente solicito alterações em projetos de código livre que Eu regularmente solicito alterações em projetos de código livre que
possuem <em>changelogs</em> não mantidos para adicionar lançamentos possuem <em>changelogs</em> não mantidos para adicionar lançamentos
que não estão presentes nestes. que não estão presentes nestes.
%p %p
Também é possível que você descubra que você esqueceu de abordar Também é possível que você descubra que você esqueceu de abordar
uma mudança abrupta nas notas para uma versão. uma mudança abrupta nas notas para uma versão.
Obviamente é importante que você atualize seu <em>changelog</em> neste caso. Obviamente é importante que você atualize seu <em>changelog</em> neste caso.
%h4#contribute %h4#contribute
@ -291,12 +291,12 @@ version: 1.0.0
Como eu posso ajudar? Como eu posso ajudar?
%p %p
Esse documento não é uma <strong>verdade absoluta</strong>; É minha Esse documento não é uma <strong>verdade absoluta</strong>; É minha
opinião cuidadosamente considerada, juntamente com informações e opinião cuidadosamente considerada, juntamente com informações e
exemplos que eu reuni. exemplos que eu reuni.
%p %p
Isso porque o que eu quero é que nossa comunidade chegue a um consenso. Isso porque o que eu quero é que nossa comunidade chegue a um consenso.
Eu acredito que a discussão é tão importante quanto o resultado final. Eu acredito que a discussão é tão importante quanto o resultado final.
%p %p
@ -305,7 +305,7 @@ version: 1.0.0
.press .press
%h3 Discussões %h3 Discussões
%p %p
Eu fui no #{link_to "<em>The Changelog podcast</em>", thechangelog} Eu fui no #{link_to "<em>The Changelog podcast</em>", thechangelog}
para falar sobre por que os mantenedores e contribuidores devem se para falar sobre por que os mantenedores e contribuidores devem se
preocupar com os <em>changelogs</em>, e também sobre as motivações preocupar com os <em>changelogs</em>, e também sobre as motivações
por trás desse projeto. por trás desse projeto.