88 lines
6.9 KiB
Markdown
88 lines
6.9 KiB
Markdown
### 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"](https://github.com/freeCodeCamp/how-to-contribute-to-open-source). É 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](https://www.freecodecamp.org/news/world-language-translation-effort).
|
||
|
||
Se você está interessado em contribuir com as traduções, certifique-se de [ler este guia](how-to-translate-files.md) 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](https://www.freecodecamp.org/news/how-to-write-for-freecodecamp/). Além disso, leia nosso [guia de estilo](https://www.freecodecamp.org/news/developer-news-style-guide/) 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](https://www.freecodecamp.org/news/how-to-contribute-to-the-freecodecamp-community-youtube-channel-b86bce4c865/).
|
||
|
||
### Como posso relatar um novo erro?
|
||
|
||
Se você acha que encontrou um erro, primeiro leia o artigo ["Socorro, encontrei um erro"](https://forum.freecodecamp.org/t/how-to-report-a-bug/19543) 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](https://forum.freecodecamp.org) 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](https://en.wikipedia.org/wiki/Software_bug#Bug_management) 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](https://github.com/freecodecamp/freecodecamp/labels).
|
||
|
||
### Por onde começar se quero ajudar em uma issue?
|
||
|
||
Você deve consultar issues [**`help wanted`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) ou [**`first timers only`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) 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 etiqueta **`first 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:
|
||
|
||
1. É muito provável que façamos o merge do primeiro pull request que resolve a issue.
|
||
2. 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?
|
||
3. 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 `Contributors` do [fórum da nossa comunidade](https://forum.freecodecamp.org/c/contributors).
|
||
- O canal `#Contributors` em nosso [servidor](https://chat.freecodecamp.org/channel/contributors).
|
||
|
||
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](https://forum.freecodecamp.org/g/team).
|
||
|
||
**Você pode enviar um e-mail para nossa equipe de desenvolvimento: `dev[at]freecodecamp.org`**
|