A documentação pode economizar muito tempo ao trabalhar com grupos, pois ajuda os membros a entender a lógica de um programa sem a necessidade de percorrê-la. Também pode ser muito útil ao aprender a codificar ou trabalhar com pessoas que estão aprendendo a codificar.
Muitos dos alunos que dou aulas particulares sempre fazem as mesmas perguntas repetidamente. Depois de instruí-los a adicionar documentação (comentários) para o que um bloco específico de código faz, eles tendem a se perder em seu código com muito menos frequência.
Por mais que eu goste de começar a programar meus projetos solo, ter algum tipo de migalhas de pão entre as sessões de programação noturnas reduz a quantidade de tempo que fico olhando para a tela sem ser produtivo.
Se você está apenas começando na programação, aprenda a criar comentários na linguagem de sua escolha e experimente.