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.
|
||
|
||
### 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.
|
||
|
||
### 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 diferentes etiquetas marcadas em 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. Por favor 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ê possui perguntas sobre as tecnologias, arquitetura da base do código, traduções, ou algo mais, fique à vontade e entre em contato com nossa equipe.
|
||
|
||
| Equipe | Envie uma mensagem no fórum |
|
||
|:--------------------- |:---------------------------------------------------------------------------- |
|
||
| Ahmad Abdolsaheb | [@abdolsa](https://forum.freecodecamp.org/u/abdolsa) |
|
||
| Kristofer Koishigawa | [@scissorsneedfoodtoo](https://forum.freecodecamp.org/u/scissorsneedfoodtoo) |
|
||
| Miya Liu | [@miyaliu](https://chinese.freecodecamp.org/forum/u/miyaliu) |
|
||
| Mrugesh Mohapatra | [@raisedadead](https://forum.freecodecamp.org/u/raisedadead) |
|
||
| Nicholas Carrigan | [@nhcarrigan](https://forum.freecodecamp.org/u/nhcarrigan) |
|
||
| Oliver Eyton-Williams | [@ojeytonwilliams](https://forum.freecodecamp.org/u/ojeytonwilliams) |
|
||
| Rafael D Hernandez | [@RafaelHernandez](https://forum.freecodecamp.org/u/rafaelhernandez) |
|
||
| Shaun Hamilton | [@sky020](https://forum.freecodecamp.org/u/sky020) |
|
||
| Tom Mondloc | [@moT01](https://forum.freecodecamp.org/u/moT01) |
|
||
|
||
**Você pode enviar um e-mail para nossa equipe de desenvolvimento: `dev[at]freecodecamp.org`**
|