CSquared, Shadow, Jeez, you're both right.
You should always document your code, certainly.
You should also always write efficiently, cutting down your function size is *usually* but not always, more efficient, and *normally* but not always, makes it easier to read.
In instances where it doesn't you should use your best judgement as an experienced developer to decide which is more valuable for that particular occasion.
There might be disagreements on case by case basis, but nobody here is forced to collaborate with each other on a project, so lets not get in fist fights over disagreements on three lines of inconsequential pseudocode.
You should always document your code, certainly.
You should also always write efficiently, cutting down your function size is *usually* but not always, more efficient, and *normally* but not always, makes it easier to read.
In instances where it doesn't you should use your best judgement as an experienced developer to decide which is more valuable for that particular occasion.
There might be disagreements on case by case basis, but nobody here is forced to collaborate with each other on a project, so lets not get in fist fights over disagreements on three lines of inconsequential pseudocode.
