Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • Passive, convoluted sentences confuse people. Active sentences are clear. The first page can and should say something like:
    Is the problem with a website that you run?
    - YES
    - NO
    After that, I'd suggest looking for anything that can possibly be (mis)read as a subtle insult and rewriting it to not be insulting. An insulted person doesn't learn - in fact they generally become impervious to learning and hence more irritating. For instance at the start of http://nms-cgi.sourceforge.net/support1.html [sourceforge.net] I'd strongly suggest making the FAQ section read something like this:
    You probably are not the first person to have the problem that you're having. Solutions to the most common problems are in our FAQs [sourceforge.net] (Frequently Asked Questions). Please read that before asking any questions on the support list.

    People often have problems with errors of the form, too late for -T option. This is addressed here [sourceforge.net] and questions on this will be referred back there unless you demonstrate that you have read that section.

    You'll note that the insult about reading ability is omitted, and the language is short and direct. That makes it more likely that people will read it rather than skimming for, "Where can I get a human? Ah, this nice form right here at the bottom."