Every few days, it seems (including today...) we have someone who posts a huge glob of Perl code and says, in effect, “fix this for me.”
Okay, I can sympathize with the latter sentiment. (Every time I go to Home Depot, I want to buy This Old House with its gang of experts; every time I burn a culinary creation, I want the “cooking-show version” of a stove...) But, the gobs of perl code, unadorned by “readmore” tags ... that is a problem because it goes on and on and on.
When I was writing this post, I momentarily forgot if the correct word was readmore (it is...), and so I went looking for it in “Markup in the Monastery” and very nearly couldn’t find it! It is not at the top of the section where you would expect it. I daresay that you would never discover its existence at all, unless you had a full five minutes with nothing better to do than to read and to read and to read some more. Hmmm...
Our instructions for how to correctly post things, while technically correct, are so wordy and long-winded that I daresay no one out there actually does read them, unless first and/or repeatedly chided to do so. (Every tech writer knows that to a certain degree you have to cajole the reader to keep reading.) Maybe we need to change some of our templates and nodes. Ideas? Thoughts?