Como Contribuir

O projeto do glossário Cloud Native é mantido nesse repositório do Github, onde você consegue encontrar todas as issues, pull requests e discussões em aberto.

Você pode contribuir de três formas:

1. Sugerindo novos termos
2. Atualizando termos existentes
3. Traduzindo o glossário para seu idioma nativo

Faça parte da comunidade do glossário

Considere participar das nossas reuniões mensais do grupo de trabalho do glossário se quiser contribuir regularmente. Você pode encontrar detalhes da reunião no calendário da CNCF. Você também pode falar com as pessoas mantenedoras e colaboradoras em nosso canal #glossary no slack da CNCF.

Sugira novos termos

Você pode sugerir um novo termo para outra pessoas trabalharem na definição ou criar você mesmo. De qualquer forma, você deve começar abrindo uma issue (importante notar que você precisa de uma conta do Github para isso).

Abaixo, temos um passo a passo para caso você ainda não esteja familiarizado com o Github. Caso você já seja familiar com o Github, garanta apenas que você está usando nossos templates de issues, com a convenção de nomes correta e seguindo o guia de estilo.

Abrindo uma issue

Vá para as issues do repositório no Github e clique em “nova issue”.

Você vai ver alguns modelos, para sugerir um novo termo em Inglês, por exemplo, selecione “English Language Glossary Request”.

Adicione o termo que está sugerindo e clique em “submit new issue”. Se você está apenas sugerindo um novo termo, está feito, para trabalhar nele siga os próximos passos.

Entre no canal #glossary no slack da CNCF e fale com @CatherinePaganini, @jmo e @SeokhoSon informando que você abriu uma issue para um novo termo e gostaria de trabalhar nisso. Assim, eles irão atribuir a issue a você, sinalizando que você já está trabalhando naquele termo.

Aqui você pode ver que os três primeiros termos estão disponíveis enquanto que o último foi atribuído a alguém.

Observe que você só pode solicitar a atribuição de um termo por vez. Se você quiser trabalhar em vários termos, termine um antes de solicitar o próximo.

Propondo um novo termo (criando um pull request)

Antes de começar, leia o guia de estilo, isso vai ajudar nos processos de revisão. Como citado no guia de estilo, recomendamos que você comece escrevendo um documento de texto.

Uma vez que o termo esteja pronto para submeter o pull request, vá para o diretório content/:

Então en/ (ou o diretório da linguagem que está propondo o termo):

e selecione o arquivo _TEMPLATE.md:

Copie o conteúdo:

E de volta ao diretório en/, clique em “add file” e selecione “Create new file”:

Adicione o nome do termo na URL (sem letras maiúsculas ou espaços) e com a extensão.md no final do arquivo. Agora cole o conteúdo do modelo abaixo. Copie e cole sua definição no arquivo. Observe que o Github usa markdown para formatar o texto (por exemplo, links, negrito, itálico). Para mais informações sobre markdown, consulte essa folha de dicas de markdown. Para ver como ficou, vá para “preview'.

Role para baixo e nomeie o arquivo que vai ser submetido quando estiver pronto. Agora você está prestes a enviar o termo para a sua própria branch do Github. Para submeter o pull request você tem que realizar mais um passo. Clique em “commit new file”:

Agora, criando o pull request:

Agora você já deve ver seu pull request em “Pull Requests”:

Atualizando um termo existente

Para atualizar um termo existente, você pode sugerir uma mudança abrindo uma issue ou diretamente criando um pull request.

Solicitando uma mudança por meio de uma issue

Se você quer informar um problema com um termo mas não sabe ou não quer corrigir você mesmo, clique em “report issue”:

Isso vai imediatamente vai abrir uma issue. Escreva quais mudanças são necessárias e o motivo. Clique em “submit” para enviar:

Atualizando diretamente um termo

Para alterar um termo diretamente, vá para “edit this page”:

Isso vai abrir a definição do termo no Github. Faça suas alterações e envie um pull request. Consulte a seção “Propondo um novo termo (criando um pull request)” acima para informações detalhadas sobre como fazer isso.

Ajude a traduzir o glossário

Para ajudar a traduzir o glossário para o seu idioma nativo, participe do canal #glossary-localizations no slack da CNCF. Você pode fazer parte de um time existente ou criar uma novo. Participe também das reuniões mensais do grupo de trabalho do glossário. Você pode encontrar detalhes da reunião no calendário da CNCF.