Tem coisa que, no dia a dia, acaba sendo tratada como detalhe, mas faz uma diferença enorme. Um exemplo é enriquecer o código com informações de autoria.
Uma vez num handover, o assunto era um projeto com centenas de scripts, cada um para resolver um problema. Em vários momentos a pessoa comentou sobre um trecho de código legado, escrito por uma terceirizada. Funciona, mas é ruim de mexer e, provavelmente, ninguém vai encostar nele, a não ser que seja realmente necessário. O clássico legado.
Aí perguntei se esse código era fisicamente identificável no projeto. A resposta foi aquele “sim, com ressalvas”.
Esse é o tipo de problema que uma tag de autoria poderia ajudar a resolver. Não para apontar culpados, mas para preservar contexto.
Em geral, uma boa documentação não serve só para explicar como o código funciona. Ela também registra quem tomou determinadas decisões, quando e, principalmente, por quê. Isso reduz o custo de handover, facilita a manutenção e evita que conhecimento importante vá embora junto com as pessoas.