Sun, 13 Dec 2009

Programming Examples, why is it?

Why is it that programmers do documentation, but when they have an example page, they do fancier things which don't match their documentation? OK, I know you get the Hello World program as a matter of course, but this is generally useless for anything beyond "Hello World". It seems, however, that programmers, if they create a sample page, for example, don't follow their own examples or make it so fancy that you have to spend hours trying to figure out how they deviated from their instructions so you can duplicate it in your own environment? It's like "C" or perl coders who think it's neat to pack as much into a single line of code as possible. Sure, it's elegant, but it's also not understandable nor maintainable.

posted 09:28 [/Technology] permanent link