8.8 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 only
sã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?
I am interested in being a moderator at freeCodeCamp. Where should I start?
Our community moderators are our heroes. Their voluntary contributions make freeCodeCamp a safe and welcoming community.
First and foremost, we would need you to be an active participant in the community, and live by our code of conduct (not just enforce it).
Here are some recommended paths for some of our platforms:
- To be a Discord/Chat moderator, have an active presence in our chat and have positive engagements with others, while also learning and practicing how to deal with potential conflicts that may arise.
- To be a Forum moderator, similar to a chat moderator, have an active presence and engage with other forum posters, supporting others in their learning journey, and even given feedback when asked. Take a look at The Subforum Leader Handbook for more information.
- To be a GitHub moderator, help process GitHub issues that are brought up to see if they are valid and (ideally) try to propose solutions for these issues to be picked up by others (or yourself).
Altogether, be respectful to others. We are humans all around the world. With that in mind, please also consider using encouraging or supportive language and be mindful of cross-cultural communication.
If you practice the above consistently for a while and our fellow moderator members recommend you, a staff member will reach out and onboard you to the moderators' team. Open source work is voluntary work and our time is limited. We acknowledge that this is probably true in your case as well. So we emphasize being consistent rather than engaging in the community 24/7.
Take a look at our Moderator Handbook for a more exhaustive list of other responsibilities and expectations we have of our moderators.
I am stuck on something that is not included in this documentation.
Feel free to ask for help in:
- The
Contributors
category of our community forum. - The
#Contributors
channel on our chat server.
We are excited to help you contribute to any of the topics that you would like to work on. If you ask us questions on the related issue threads, we will be glad to clarify. Be sure to search for your question before posting a new one.
Thanks in advance for being polite and patient. Remember – this community is run mainly by volunteers.
Additional Assistance
If you have queries about the stack, architecture of the codebase, translations, or anything else feel free to reach out to our staff team on the forum.
You can email our developer staff at: dev[at]freecodecamp.org