Onboarding em um projeto novo

Um roteiro para entender um projeto existente e fazer a primeira contribuição com segurança.

5 min de leitura · Iniciante · Revisado em

O objetivo das primeiras semanas

Onboarding é o processo de se integrar a um projeto ou empresa: tecnicamente, nos processos e na cultura. O objetivo não é entender tudo. É conseguir fazer uma mudança pequena com segurança e saber a quem perguntar.

Um roteiro em três etapas

  1. Leia a documentação em alto nível

    README, arquitetura e regras de negócio principais. Depois, explique o que entendeu para alguém do time, em um desenho ou em uma conversa. As correções que você receber valem mais que horas de leitura.

  2. Rode o projeto na sua máquina

    Instale, rode os testes e abra a aplicação. Escolha uma funcionalidade e siga o fluxo pelo código: da tela ou endpoint até o banco, passando pelos logs.

  3. Pegue uma tarefa pequena

    Um bug simples ou um ajuste de texto. Ele ensina o caminho completo: branch, testes, revisão, deploy. Aumente a complexidade aos poucos.

Checklist da primeira semana

  • Consigo instalar e rodar o projeto do zero seguindo o README
  • Rodei a suíte de testes e sei quanto tempo ela leva
  • Sei como uma mudança chega à produção (CI, revisão, deploy)
  • Segui uma funcionalidade da interface até o banco de dados
  • Sei onde ficam os logs e os painéis de monitoramento
  • Sei quem procurar para dúvidas de produto, de código e de acesso
  • Abri meu primeiro pull request, mesmo que pequeno
  • Corrigi ou completei algo no README que estava desatualizado

Anote o que aprender em um documento seu: comandos, decisões, siglas, pessoas. Ele vira referência para dúvidas futuras e, depois, uma contribuição para o próximo que chegar.

Trilhas relacionadas