APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
Os ficheiros de orientação respondem a necessidades diferentes. README apresenta propósito, arranque e contactos; CONTRIBUTING explica como propor alterações; SECURITY indica reporte de vulnerabilidades e versões suportadas; LICENSE define termos de reutilização. Um repositório público sem licença identificada não deve ser tratado como autorização geral para incorporar e distribuir código. CODEOWNERS identifica responsáveis por caminhos e pode gerar pedidos de revisão, mas a exigência de aprovação depende de regras configuradas. Confirma também que os owners têm permissões adequadas e que o ficheiro aplicável corresponde à branch de destino. Documentar intenção e impor uma condição técnica são ações complementares, não equivalentes.
Aplicação guiada
Num projeto fictício, usa um template aprovado para iniciar uma aplicação com estrutura comum e histórico próprio. Um fork preserva a relação com o projeto de origem e serve outro objetivo de colaboração. Alterações posteriores ao template não atualizam automaticamente todos os projetos criados a partir dele; planeia manutenção das convenções. Quando uma biblioteca deixa de ser mantida, atualiza o aviso, identifica substituição e considera arquivo para manter consulta do histórico. Arquivar não é um backup independente nem uma garantia de retenção regulamentar. Usa insights e métricas como sinais de atividade, não como prova isolada de qualidade. Muitas stars ou commits frequentes não demonstram que uma dependência satisfaz os requisitos técnicos e operacionais.
CODEOWNERS presente, aprovação não exigida: o owner pode ser notificado sem existir um bloqueio de merge.
Armadilhas comuns
Template como sincronização; ficheiro como enforcement; público como licença; arquivo como backup; popularidade como qualidade.
Tópicos relacionados: Git, estado local e colaboração · Conversas, rastreabilidade e partilha · Automação, ambientes de desenvolvimento e IA
Distingue instruções, permissões, regras e ciclo de manutenção do repositório.
Referência: CODEOWNERS and required review · GH-900 skills measured January2026;study guide updated2026-02-19