Documentation Woes

Is it perhaps worse to say too much
Than to say hardly anything at all?
To spew great verbosity and such
Versus a trail of bread crumbs too small?

What truths will I hide buried so deep
When I ramble far beyond the point?
Who will know what are the facts to keep
When I scatter words all over the joint?

But when I cut the clue to a phrase,
Those few selected hints of meaning,
Whose understanding will I so faze
That its message is beyond gleaning?

There is a reason why it comes last,
If ever the manual is written.
It is not what gives coders a blast
Once with a problem, they are smitten.

Such drudgery not for them intended,
So the programmers will tell you all.
Hire English majors with words splendid
To capture the thoughts and you enthrall.