Primeira contribuição
Ponto de entrada para estudantes aprenderem a editar a wiki, abrir PRs e participar do fluxo de revisão.
A primeira contribuição deve ser pequena, revisável e útil. O objetivo é que o estudante entenda como o CPPS organiza conteúdo, documentação, preview e revisão antes de entrar em tarefas maiores de dados, desenvolvimento ou infraestrutura.
Esta página é uma ponte. Os guias operacionais ficam em /editar-site, para evitar duplicação e manter o fluxo de contribuição em um só lugar.
Guias obrigatórios
Início rápido
Fluxo resumido para começar a contribuir com o site.
Markdown e MDX
Sintaxe básica, frontmatter, tabelas, links, imagens e blocos de código.
Criar arquivos
Como organizar arquivos, coleções, pastas e menu lateral.
Escrever páginas
Como usar componentes como Notice, CardGrid, LinkCard e Steps.
Pré-visualizar alterações
Branch, pull request, Codespaces, preview automático e revisão.
Problemas comuns
Como resolver erros de build, YAML, imagens, CI e MDX.
Entrega mínima
Escolha uma das opções:
- corrigir um erro de texto ou link;
- melhorar um exemplo em uma página didática;
- adicionar uma explicação curta onde houver lacuna;
- propor um exercício simples;
- abrir uma issue bem descrita para um problema encontrado;
- revisar se uma página tem objetivo, exemplo e próximo passo.
Fluxo recomendado
Ler os guias
Comece pelos guias de /editar-site, principalmente Markdown e MDX, criação de arquivos e pré-visualização de alterações.
Escolher uma tarefa pequena
Prefira tarefas que possam ser revisadas rapidamente. Uma primeira contribuição não deve depender de refatoração grande.
Fazer a alteração
Edite o arquivo correto, mantenha o texto simples e evite mudar conteúdos não relacionados.
Abrir pull request
Descreva o que foi alterado, confira o preview e responda à revisão.
Registrar aprendizado
Se encontrou uma dúvida recorrente, transforme a dúvida em melhoria de documentação ou issue.
Próximo passo
Depois da primeira contribuição, siga para a base comum ou escolha uma trilha de colaboração.