Ajuda

Precisa de uma ajuda com o coderkrow? Seja explorando o site, entrando na comunidade, trabalhando com um dos nossos projetos, ou algo simplesmente não se comportando como deveria, este é o lugar para começar.

O que é o coderkrow?

O coderkrow é um projeto independente e uma comunidade de desenvolvimento de software. Focamos em construir coisas, compartilhar conhecimento, experimentar tecnologia e documentar o processo.

Você pode explorar o ecossistema através de:

• Projetos: software, experimentos, ferramentas e trabalho open source.
• Documentação: guias técnicos e documentação de projetos.
• Blog: notas de desenvolvimento, artigos técnicos e opiniões.
• Comunidade: discussões, colaboração e conteúdo para desenvolvedores.
• GitHub: código fonte, issues, discussões e contribuições.

Para onde devo ir?

Use isto como um mapa rápido:

• Aprender sobre o coderkrow: página Sobre.
• Explorar projetos: página Projetos.
• Ler conteúdo técnico: Blog.
• Ler documentação: Documentação.
• Ver o código fonte: GitHub.
• Entrar na comunidade: Comunidade.
• Reportar um bug: GitHub Issues.
• Sugerir uma função: GitHub Discussions.
• Contribuir: guia de contribuição.
• Reportar um problema de segurança: página Segurança.
• Entender como usamos os dados: Política de Privacidade.
• Entender as regras: Termos de Serviço.

Algo está quebrado?

Se você encontrou um bug em um dos nossos projetos, reporte através dos GitHub Issues do projeto em vez de nos contatar com uma descrição vaga.

Um bom relatório de bug inclui:

O que aconteceu?
O que você esperava que acontecesse?
Como podemos reproduzir?
Qual projeto/versão você está usando?
Em que ambiente você está executando?

Se possível, inclua:

• Uma reprodução mínima.
• Logs ou stack traces relevantes.
• Capturas de tela.
• Informações do navegador e do sistema operacional.
• Versão do projeto ou commit.
• Passos para reproduzir o problema.

Antes de abrir um issue

Por favor, verifique se:

1. O issue já existe.
2. A documentação do projeto aborda isso.
3. Você está usando uma versão suportada.
4. O problema pode ser reproduzido de forma consistente.
5. O issue está realmente relacionado ao projeto.

Nunca inclua senhas, API keys, tokens de acesso, chaves privadas ou outros segredos em um issue.

Tem uma ideia?

Nem todo problema precisa ser resolvido com um pull request.

Se você tem uma ideia para melhorar um projeto do coderkrow, proponha através das discussões ou do issue tracker do projeto.

Boas propostas explicam:

• O problema que você está tentando resolver.
• Por que o comportamento atual é insuficiente.
• Quem se beneficiaria da mudança.
• O que você gostaria de ver melhorado.
• Alternativas que você considerou.

Nós nos importamos com o problema antes da implementação.

Encontrou um bug?

Bugs acontecem. Isso é software.

Ao reportar um, não se preocupe em deixar o relatório perfeitamente técnico. Comece com o que você sabe:

Eu fiz X, esperava Y, mas obtive Z.

Isso é suficiente para começar. Se puder fornecer mais informações técnicas, melhor ainda.

Quer contribuir?

Os projetos do coderkrow podem estar abertos a contribuições, depende do repositório.

Antes de contribuir:

1. Leia o README do projeto.
2. Verifique as diretrizes de contribuição.
3. Olhe os issues e discussões existentes.
4. Evite duplicar trabalho que já está em andamento.
5. Mantenha as mudanças focadas.
6. Siga as convenções existentes do projeto.
7. Teste suas mudanças antes de enviar.

Para mudanças maiores, abrir uma discussão antes de implementar pode economizar tempo de todos.

Contribuições não precisam ser código

Você também pode contribuir:

• Reportando bugs.
• Melhorando a documentação.
• Corrigindo typos.
• Compartilhando ideias.
• Testando releases.
• Melhorando exemplos.
• Revisando mudanças.
• Ajudando outros membros da comunidade.

Não encontra a documentação?

A documentação evolui continuamente.

Se algo está faltando, confuso ou desatualizado, nos avise.

Um issue de documentação pode ser tão simples quanto:

Este exemplo não funciona mais.

ou:

Eu segui estas instruções e obtive este erro.

Isso é informação útil.

Comunidade

A comunidade coderkrow reúne desenvolvedores e entusiastas de tecnologia da LATAM e além.

A comunidade é multilíngue e pode incluir conteúdo em:

• Espanhol
• Português
• Inglês

Você não precisa ser especialista para participar.

Faça perguntas, compartilhe o que está construindo, discuta tecnologia, mostre seus projetos ou simplesmente fique por perto.

O objetivo não é fingir que tudo funciona perfeitamente.

É construir, quebrar, aprender e fazer de novo.

Discord

O Discord da comunidade é o melhor lugar para conversas informais e interação em tempo real.

Use para:

• Discussões gerais de desenvolvimento.
• Conversas sobre projetos.
• Compartilhar o que você está construindo.
• Pedir conselhos.
• Eventos da comunidade.
• Discussões técnicas.
• Networking com outros desenvolvedores.

Para bugs acionáveis e problemas específicos de projetos, prefira GitHub Issues para que possam ser rastreados e resolvidos adequadamente.

Segurança

Encontrou uma vulnerabilidade de segurança?

Não publique detalhes sensíveis de vulnerabilidades em um issue público ou canal da comunidade.

Relatórios de segurança devem ser tratados pelo processo de reporte designado.

Ao reportar uma vulnerabilidade, forneça informações suficientes para reproduzir e avaliar o problema, minimizando a exposição de informações sensíveis.

Privacidade

Tenha cuidado ao compartilhar informações publicamente.

Nunca publique:

• Senhas.
• API keys.
• Tokens de autenticação.
• Chaves privadas.
• Credenciais de banco de dados.
• Informações pessoais de outra pessoa.
• Dados privados de clientes ou usuários.

Se você expor uma credencial por acidente, revogue a credencial imediatamente. Não simplesmente apague a mensagem ou o arquivo.

Para saber como o coderkrow lida com informações pessoais, veja a Política de Privacidade.

Políticas

Estas páginas contêm as regras e políticas que regem o coderkrow:

• Termos de Serviço
• Política de Privacidade
• Política de Marca Registrada
• Segurança
• Diretrizes da Comunidade

Se você está contribuindo para um repositório open source, verifique também a licença e as diretrizes de contribuição do próprio repositório.

Ainda preso?

Se você passou pela documentação e ainda não encontrou uma resposta, tudo bem.

Comece pelo lugar mais relevante:

Pergunta sobre um projeto?
  Verifique o README ou a documentação
    Ainda preso?
      Procure nos GitHub issues existentes
        Ainda preso?
          Abra um issue ou discussão

Quer conversar?
  Entre na comunidade

Encontrou uma vulnerabilidade de segurança?
  Use o processo de reporte de segurança

Encontrou algo errado neste site?
  Reporte ao projeto coderkrow

Em caso de dúvida, nos conte o que você estava tentando fazer, o que aconteceu e o que esperava em vez disso.

Isso geralmente é suficiente para saber para onde ir.

A versão curta

• Construa algo.
• Quebre algo.
• Faça perguntas.
• Compartilhe o que aprendeu.
• Ajude outra pessoa.

E quando algo inevitavelmente explodir:

Verifique os logs primeiro.