Submódulo 3: Git e colaboração para projetos em Python

🧭 Versionamento, documentação e portfólio

Chegamos ao coração da gestão de versões do seu portfólio. Em termos de versionamento, o Git permite marcar pontos importantes do histórico com tags, que funcionam como releases. Use git tag para criar uma etiqueta associada ao último commit ou a um commit específico, facilitando o rastreamento de versões públicas (1). As tags simples costumam seguir uma convenção leve, como v0.1.0, sem grandes complicações. Em paralelo, mantenha o código bem documentado com um README central que sirva como índice para os seus diferentes projetos. A documentação oficial do Git descreve o uso de tags e seu papel no versionamento (1).

Para garantir reprodutibilidade, inclua um arquivo de dependências, como requirements.txt, para congelar as bibliotecas necessárias. Considere também a prática de manter o repositório limpo com um template de .gitignore adequado ao Python (3) e a orientação de Ignorar arquivos sensíveis com as melhores práticas da GitHub (4). A combinação de tags, documentação clara e repositórios bem organizados facilita a demonstração do seu portfólio a recrutadores e equipes técnicas (1)(3)(4).

Além disso, adote abordagens simples de testes de integração para verificar se as mudanças não quebram o funcionamento existente. A integração com pipelines simples de CI pode ser explorada no próximo módulo. Por fim, a consistência entre dependências, documentação e histórico de commits é o que transforma um portfólio em uma vitrine profissional. A visão prática é: versionar com tags, documentar com README e manter o ambiente reproduzível via requirements.txt (1).