Comments by "Anony Mousse" (@anon_y_mousse) on "Is Too Much Documentation Bad? (Is No Documentation OK?)" video.

  1. Indeed, documentation of the source and operation of the program should be thought of as separate. The programmer should document as they go, with comments. If possible they should also document the operation of the program, but they aren't generally working alone on a project and that would need to be corroborated with colleagues. So it'd be really helpful if the person documenting the operation could program but didn't necessarily contribute to the source but instead read through it and the comments to write the manual. Might be too much to expect a single developer use their time that way for a smaller project, but would be great for big ones.
    2