Skip to content

Latest commit

 

History

History
156 lines (89 loc) · 10.1 KB

CONTRIBUTING.md

File metadata and controls

156 lines (89 loc) · 10.1 KB
Read these guidelines in English عربي 中文 Português русский Español

Orientações para Contribuição

Olá 👋!

freeCodeCamp.org é possível graças a milhares de voluntários gentis como você. Somos gratos por suas contribuições e estamos felizes em te receber.

Nós seguimos as diretrizes do nosso "Código de Conduta". Dedique um tempo para lê-lo. Ele não é muito longo.

Divirta-se contribuindo 🎉!

Esses são alguns jeitos divertidos de contribuir

Você pode escolher contribuir para uma área do seu interesse:

  1. Contribua para essa base de códigos abertos.

    Nos ajude criando e editando Artigos de guias, desafios de código e corrigindo bugs na plataforma de aprendizado.

  2. Ajude campistas em nosso fórum público.

  3. Nos ajude a legendar nosso canal no YouTube.

Contribua para essa base de códigos abertos

Nós temos uma base de código aberto gigantesca dos Desafios de código e Artigos de guia. Esses desafios e artigos compõem o conteúdo de aprendizado disponível na plataforma de aprendizado da freeCodeCamp.org.

Você pode nos ajudar:

Pesquise, Escreva e Atualize nossos artigos de guia

O que são Artigos de guia?

Artigos de guia ajudam você a ter um rápido entendimento sobre um conceito tecnológico. Eles são explicações em Português, curtas e diretas, que você pode ler antes de partir para recursos mais aprofundados.

Você pode encontrar um artigo de exemplo sobre elementos HTML aqui.

Sobre o que eu posso escrever um artigo?

Nós agradecemos sua ajuda na escrita desses artigos. Você não precisa ser um especialista em um tópico para escrever sobre isso - Todo o Guia é código aberto, então mesmo que você cometa um erro, outro contribuidor vai eventualmente corrigí-lo.

Para ajudar, encontre um artigo provisório na página de Guias, escreva o artigo, e então abra um pull request (PR) para substituir o provisório pelo seu artigo. Um pull request é a forma como você vai sugerir mudanças. Ele permite que outros saibam das suas mudanças, revisem-nas e as adotem.

Se você não consegue encontrar um artigo provisório do tópico sobre o qual você gostaria de escrever, você pode abrir um PR que cria o artigo provisório e então incluir o rascunho do seu artigo.

Se você gostaria de trabalhar nisso, por favor, siga as seguintes recomendações:

Crie, Atualize e Corrija Bugs em nossos desafios de código

Todos os nossos Desafios de código tem curadoria da comunidade, trazendo conhecimento especializado de voluntários como você. Entretanto, eles precisam ser constantemente refinados para melhor qualidade. Por exemplo, você pode querer atualizar suas instruções para melhorar seu palavreado. Você pode atualizar as histórias de usuário para explicar o conceito melhor ou mesmo evitar redundâncias. Você pode querer refatorar testes que não passam em códigos válidos das histórias de usuário.

Se você gostaria de trabalhar nisso, por favor, siga as seguintes recomendações:

Traduza artigos de guia e desafios de código

Você pode nos ajudar a traduzir nossos Artigos de guia e Desafios de código para uma língua que você fala. Atualmente, nós temos versões traduzidas em:

  • Chinês (中文)
  • Russo (русский)
  • Árabe (عربي)
  • Espanhol (Español)
  • Português (Português)

A maioria dessas versões são traduções de máquina. Nós vamos amar sua ajuda em melhorar a qualidade dessas traduções.

Se você gostaria de trabalhar nisso, por favor, siga as seguintes recomendações:

[TODO] Nós estamos no processo de atualizar os documentos para o fluxo de tradução. Siga #18313 para acompanhar o progresso.

Nos ajude a corrigir bugs na plataforma de aprendizado da freeCodeCamp.org

Nossa plataforma de aprendizado roda em uma stack moderna de Javascript. Ela contém vários componentes, ferramentas e bibliotecas, incluindo, mas não limitadas a: Node.js, MongoDB, LoopBack, OAuth 2.0, React, Gatsby, Webpack, entre outras.

De maneira geral,

  • Nós temos um servidor de API baseado em Node.js.
  • Um conjunto de aplicações cliente baseadas em React.
  • Um script que nós utilizamos para avaliar nossos projetos Frontend.

Contribuir para isso requer certo conhecimento de APIs, sintaxe ES6 e bastante curiosidade.

Nós esperamos certa familiaridade básica com algumas das tecnologias, ferramentas e bibliotecas mencionadas. Dito isso, não é necessário que você seja um especialista nelas.

Sinta-se livre para nos fazer qualquer pergunta nos tópicos de questões relacionadas, e nós seremos gratos em explicar. Quando em dúvida, você pode contatar Mrugesh Mohapatra @raisedadead ou Stuart Taylor @bouncey do nosso time de desenvolvimento da plataforma para o ajudar.

Se você gostaria de trabalhar nisso, por favor, siga as seguintes recomendações:

Perguntas Frequentes

Como eu posso reportar um bug?

Se você acha que encontrou um bug, primeiro leia o artigo "Help I've Found a Bug" e siga as instruções.

Se você está confiante de que se trata de um bug novo, vá em frente e crie uma nova issue no GitHub. Certifique-se de incluir o máximo de informações possível para que nós possamos reproduzir o bug. Nós temos um modelo pré definido para issues para ajudá-lo nisso.

Por favor, repare que qualquer issue que esteja buscando ajuda no código de algum desafio será fechada. O acompanhador de issues é restrito a problemas e discussões relacionadas à base de código. Você deve buscar ajuda no fórum antes de reportar sempre que estiver em dúvida.

Como eu posso reportar um problema de segurança?

Por favor não crie issues relacionadas à segurança no GitHub. Ao invés disso, por favor envie um email para [email protected] e nós iremos analisar imediatamente.

Estou parado em algo que não está nessa documentação. Como posso conseguir ajuda?

Sinta-se livre para pedir ajuda:

Nós estamos empolgados em te ajudar a contribuir para qualquer tópico em que você queira trabalhar. Certifique-se de fazer uma busca antes de publicar um tópico novo. Seja educado e paciente. Os voluntários e moderadores da nossa comunidade estão sempre por perto para te ajudar em suas questões.

Eu sou novo no GitHub e Open Source (Código Aberto) em geral:

Leia nosso Guia de como contribuir para Open Source.

O que esses rótulos diferentes marcados nas issues significam?

Nossa comunidade de moderadores faz uma triagem das issues e pull requests baseada em suas prioridades, gravidade e outros fatores. Você pode encontrar um glossário completo dos seus significados aqui.

Você deveria passar pelas issues de Help Wanted (Ajuda necessária) ou first timers welcome (Iniciantes são bem vindos) para uma rápida consulta do que está livre para você trabalhar. Elas estão disponíveis e você não precisa de permissão para começar a trabalhar nelas.

Se essas issues possuem falta de clareza do que deve ser feito, sinta-se livre para tirar suas dúvidas nos comentários.

Encontrei um erro de escrita, eu devo reportar antes de criar um pull request?

Você pode criar diretamente um pull request sem ter de reportar uma issue em casos de erros de escrita ou pequenas mudanças de palavreado. Issues são ferramentas para buscar confirmação em mudanças que você gostaria de propor por meio de um pull request.