Comments on: Source code is the best form of documentation (not) http://t-machine.org/index.php/2007/09/14/source-code-is-the-best-form-of-documentation-not/ Internet Gaming, Computer Games, Technology, MMO, and Web 2.0 Thu, 29 Jul 2010 16:26:58 +0100 http://wordpress.org/?v=2.8.5 hourly 1 By: Fiordean Dacian http://t-machine.org/index.php/2007/09/14/source-code-is-the-best-form-of-documentation-not/comment-page-1/#comment-24 Fiordean Dacian Fri, 14 Sep 2007 10:05:42 +0000 http://tmachine1.dh.bytemark.co.uk/blog/index.php/2007/09/14/source-code-is-the-best-form-of-documentation-not/#comment-24 Now that's an interesting point of view, I didn't think about it. I just want to add a point: documenting an existing system is just boring. Writing unit tests is more valuable. I had to document an already existing application some time ago and generate some html out of it. The odd thing was that I wasn't the creator of that application, and the programmers who wrote the code were not part of the team anymore. I did it because I was paid for it, but I'm sure it was wrong, useless and man, boring. Now in this case I think your scenario fits like a glow and unit tests come might really help. Dacian Now that’s an interesting point of view, I didn’t think about it.

I just want to add a point: documenting an existing system is just boring. Writing unit tests is more valuable.

I had to document an already existing application some time ago and generate some html out of it. The odd thing was that I wasn’t the creator of that application, and the programmers who wrote the code were not part of the team anymore. I did it because I was paid for it, but I’m sure it was wrong, useless and man, boring. Now in this case I think your scenario fits like a glow and unit tests come might really help.

Dacian

]]> By: adam http://t-machine.org/index.php/2007/09/14/source-code-is-the-best-form-of-documentation-not/comment-page-1/#comment-23 adam Fri, 14 Sep 2007 03:09:16 +0000 http://tmachine1.dh.bytemark.co.uk/blog/index.php/2007/09/14/source-code-is-the-best-form-of-documentation-not/#comment-23 (all due to a conversation I had with JT (?) where this came up and it seemed worth retelling to a wider audience...) (all due to a conversation I had with JT (?) where this came up and it seemed worth retelling to a wider audience…)

]]>