Não sou um usuário high-end de git, uso o basicão dele e entendo alguns comandos avançados, mas uma coisa q me veio na cabeça (não sei se já existe algo implementado), é se o git tivesse um tipo de verificador dos históricos de documentações. Seria uma ferramenta extra do git (ou até uma outra ferramenta q associe a ele), onde permite que o usuário (a gente) rodar um comando para checar se existe algum método/classe q teve alteração. Se a documentação não foi alterada desses casos de alteração, ele mostraria um alerta, sendo q pode ter 2 ações do usuário, ou aceitar q não precisa de atualização, ou precisa atualizar a documentação, sendo q nesse segundo ele precisaria atualizar a documentação antes de passar pra frente.

Isso é só uma ideia louca q tive agora com base no q o GheistLycis disse acima, não pretendo ir mais a fundo, mas ter esse tipo de ferramenta seria mto legal para dar suporte a nós, para sempre estar atento as nossas documentações. E por ser optativo, usaria quem quiser, pois não acho q isso deva ser um impeditivo obrigatório para entrega de uma PR.

Edit: dando uma rápida busca pelo copilot, ele disse q existe sim ferramentas q faz isso. Como não usei, não posso dizer mto sobre a qualidade e eficácia, mas pode ser uma mão na roda qm souber integrar isso.