Muitas vezes, quando eu herdei ou encontrei código científico escrito por outras pessoas (ou ocasionalmente, até meu próprio trabalho), notei que a documentação é esparsa ou inexistente. Se tiver sorte, vejo comentários informativos. Se eu tiver muita sorte, há até comentários Doxygen e um Doxyfile...