Obrigado pelo interesse em contribuir! Este projeto é open source e colaborações são muito bem-vindas. Aqui está como você pode ajudar:
Formas de Contribuir
1. Dê uma Estrela
A forma mais simples de apoiar o projeto é dando uma estrela no repositório!
2. Reporte Bugs ou Problemas
Encontrou algo errado?
- Abra uma Issue
- Descreva o problema claramente
- Inclua exemplos se possível
3. Sugira Melhorias
Tem ideias para melhorar o framework?
- Abra uma Issue com a tag `enhancement`
- Explique sua proposta
- Descreva o benefício para os usuários
4. Melhore a Documentação
- Corrija erros de digitação ou gramática
- Adicione exemplos práticos
- Esclareça seções confusas
- Traduza para outros idiomas
5. Contribua com Código/Conteúdo
- Crie novos templates
- Desenvolva guias práticos
- Adicione exemplos de ladders por área
- Melhore visualizações e diagramas
6. Compartilhe Experiências
- Relate como implementou o framework na sua empresa
- Compartilhe aprendizados e adaptações
- Participe de discussões nas Issues
Processo de Contribuição
Para Mudanças Pequenas (typos, correções, melhorias pontuais)
- Fork o repositório
- Crie uma branch:
git checkout -b fix/typo-manifesto - Faça suas mudanças
- Commit:
git commit -m "fix: corrige typo no manifesto" - Push:
git push origin fix/typo-manifesto - Abra um Pull Request
Para Mudanças Grandes (novos documentos, features)
- Abra uma Issue primeiro descrevendo sua proposta
- Aguarde feedback/aprovação
- Siga o processo acima após aprovação
Diretrizes de Contribuição
Documentação
- Linguagem: Clara, objetiva e acessível
- Estrutura: Siga o padrão existente (headings, formatação)
- Links: Sempre use caminhos relativos
- Imagens: Coloque em
./assets/e referencie adequadamente
Código de Conduta
- Seja respeitoso e construtivo
- Evite linguagem ofensiva ou discriminatória
- Foque no problema, não na pessoa
- Aceite feedback com mente aberta
Estilo de Escrita
Português (pt-BR):
- Use linguagem neutra de gênero quando possível
- Prefira "profissional" a "profissional(a)"
- Seja inclusivo
English (en-US):
- Use American English spelling
- Keep language professional and inclusive
Commits
Use commits semânticos:
feat:para novos recursosfix:para correçõesdocs:para documentaçãostyle:para formataçãorefactor:para refatoraçõestest:para testes
Exemplo: docs: adiciona seção de competências em nivelamento
Tradução
Quer traduzir para outro idioma?
- Crie pasta
docs/[código-idioma]/(ex:docs/es-ES/) - Traduza os arquivos mantendo estrutura
- Atualize README principal com link para novo idioma
- Abra PR com tag
translation
Testando Suas Mudanças
Antes de abrir PR:
- ☐ Verifique links quebrados
- ☐ Confirme que Markdown renderiza corretamente
- ☐ Revise gramática e ortografia
- ☐ Certifique-se de que imagens carregam
Contato
Dúvidas sobre como contribuir?
- Issues: Para discussões públicas
- LinkedIn: guilherme-dos-santos para contato direto
Licença
Ao contribuir, você concorda que suas contribuições serão licenciadas sob a mesma licença do projeto.
Agradecimentos
Obrigado por dedicar seu tempo para melhorar o Career Topologies!
Toda contribuição, grande ou pequena, é valorizada.