6.9 KiB
Eu sou novo no GitHub e em código aberto. Por onde devo começar?
Leia nosso "Guia de como contribuir com código aberto". É uma referência ampla para quem contribui com projetos pela primeira vez. E inclui muitas dicas de como contribuir para código aberto.
O que eu preciso saber para contribuir com a base de código?
O freeCodeCamp é executado em uma stack de JavaScript moderna. Se estiver interessado em contribuir com a nossa base de código, você precisará ter alguma familiaridade com JavaScript e com algumas das tecnologias que usamos como o Node.js, MongoDB, OAuth 2.0, React, Gatsby e Webpack.
Posso traduzir os recursos do freeCodeCamp?
Sim. Você pode contribuir com qualquer um dos mais de 30 idiomas disponíveis em nossa plataforma de tradução.
Temos traduções enviadas por usuários ao vivo em alguns idiomas. Pretendemos traduzir o freeCodeCamp para vários idiomas. Você pode ler mais sobre isso em nosso anúncio aqui.
Se você está interessado em contribuir com as traduções, certifique-se de ler este guia primeiro.
Posso contribuir com artigos para o editorial do freeCodeCamp ou com vídeos para o canal do YouTube do CodeCamp?
Sim - você pode contribuir com o nosso blog de publicação e com o canal do YouTube.
Se estiver interessado em escrever artigos para o editorial do freeCodeCamp, visite este guia de publicação. Além disso, leia nosso guia de estilo pois ele ajudará você a escrever artigos mais sólidos e eficazes.
Para nos ajudar a fazer vídeos educacionais para nosso canal do YouTube, você pode seguir o guia do canal do YouTube aqui.
Como posso relatar um novo erro?
Se você acha que encontrou um erro, primeiro leia o artigo "Socorro, encontrei um erro" e siga suas instruções.
Se você está confiante de que é um novo erro, vá em frente e crie uma nova issue no GitHub. Certifique-se de incluir o máximo de informações possível para que possamos reproduzir o erro. Temos um modelo predefinido de issue para ajudar você.
Observe que essas issues do GitHub são para discussões e questões relacionadas ao código – não para obter ajuda sobre como aprender a programar. Sempre que houver dúvidas, você deve procurar por assistência no fórum antes de criar uma issue no GitHub.
Como posso relatar um problema de segurança?
Não crie issues no GitHub para problemas de segurança. Em vez disso, envie um e-mail para security@freecodecamp.org e nós vamos investigar isso imediatamente.
Eu sou estudante. Posso trabalhar em um recurso para créditos acadêmicos?
Sim. Note, porém, que não podemos nos comprometer com nenhum cronograma ou documentação que possa ser um requisito da sua faculdade ou universidade. Recebemos muitos pull-requests e contribuições em código de desenvolvedores voluntários e respeitamos o tempo e esforço deles. Em respeito a todos os outros contribuidores, não daremos nenhuma prioridade especial a nenhum PR só por ser relacionado à escola.
Pedimos que você planeje com antecedência e que trabalhe em suas contribuições de código tendo isso em mente.
O que significam estas etiquetas diferentes marcadas nas issues?
Os responsáveis pelo código fazem a triagem das issues e pull requests tendo como base a prioridade, importância e outros fatores. Você pode encontrar um glossário completo dos significados aqui.
Por onde começar se quero ajudar em uma issue?
Você deve consultar issues help wanted ou first timers only para saber o que está disponível para ajuda.
[!TIP] Você não precisa pedir permissão para ajudar com issues marcadas como
help wanted. No entanto, issues com a etiquetafirst timers onlysão issues especiais projetadas para pessoas que não contribuíram antes para a base de código freeCodeCamp.
Encontrei um erro de digitação. Devo relatar uma issue antes de poder fazer um pull request?
Para erros de digitação e outras mudanças em palavras, você pode diretamente abrir pull requests sem criar uma issue antes. Certifique-se de mencionar detalhes na descrição do pull request para nos ajudar a entender e revisar sua contribuição – mesmo se for uma mudança pequena.
Crie uma issue se quiser discutir grandes aspectos da base do código ou currículo.
Como posso receber uma issue atribuída a mim?
Tipicamente, não atribuímos issues para ninguém além de contribuidores de longo prazo. Ao invés disso, seguimos a política abaixo para sermos justos com todos:
- É muito provável que façamos o merge do primeiro pull request que resolve a issue.
- No caso de vários colaboradores abrindo um pull request para a mesma issue, ao mesmo tempo, daremos prioridade ao pull request que melhor resolve a issue. Algumas coisas que consideramos:
- Você incluiu testes?
- Você usou todos os casos de uso?
- Você garantiu que todos os testes passaram e confirmou que tudo está funcionando localmente?
- Por último, damos prioridade aos pull requests que seguem as nossas orientações recomendadas.
- Você seguiu a checklist do pull request?
- Você deu um título significativo ao seu pull request?
Estou com dificuldade em algo que não está incluído na documentação.
Fique à vontade para pedir ajuda em:
- A categoria
Contributorsdo fórum da nossa comunidade. - O canal
#Contributorsem nosso servidor.
Estamos animados em ajudar você a contribuir com qualquer tópico que desejar. Se você nos perguntar algo relacionado às issues, vamos ficar felizes em esclarecer. Certifique-se de pesquisar sua pergunta antes de postar uma nova.
Agradecemos antecipadamente por ser educado(a) e paciente. Lembre-se – esta comunidade é feita principalmente de voluntários.
Assistência adicional
Se você tiver dúvidas sobre a stack, a arquitetura do código, as traduções ou qualquer outra coisa, pode entrar em contato com nossa equipe no fórum.
Você pode enviar um e-mail para nossa equipe de desenvolvimento: dev[at]freecodecamp.org