re: 10 More Mistakes you probably also made in your coding task for a new job Part 2 VIEW POST

TOP OF THREAD FULL DISCUSSION
re: It's true that all programmers need to ensure that their code remains readable, and again, this could also be the one more reason to use descriptiv...

It's not easy to make fixed rules about these things, but I do believe that too little documentation is the enemy of maintainable code. In the end we have to rely on the professionalism and common sense of the programmer. If (s)he doesn't have any we're doomed anyway.

I think I'm generally in agreement with what you say. I advocate the implementation of 'user stories' as high-level code, if only as a set of single-use functions, to match (where possible) the project brief supplied by the client. Then it's quite clear what the intention of the program is without the need for excessive documentation. That tends to answer the "why?" question that the code itself rarely reveals.

code of conduct - report abuse