[drupal-devel] [feature] More improvements to forum help language

Steve Dondley s at dondley.com
Sat Mar 12 11:24:38 UTC 2005

Morbus Iff wrote:

> * Never use location in documentation or help instructions. The stuff
> may be "below" or "above" your help text now, but that doesn't mean it
> is always going to be like that (ie. prevent the possibility of future
> "incorrect" documentation). 

I think user readability and clarity should take precedence over such a 
minor maitenance issue.

> * You didn't do a spellcheck. What's "apporpriate"?

I will fix this.  But I think you can guess what the word is supposed to 
be, can't you?  Why the sarcasm?  I'm a grown man not a schoolboy.  From 
now on, please simply tell me: "You misspelled 'appropriate'"  It's 
shorter and not insulting.

> * I don't like the use of the word "many". It's extraneous, not
> finitely defined, and ultimately garbage.

I like it.  It's succinct and everyone know what many means.  I'm not 
writing an engineering text book, I'm writing a helpful, user-friendly 

Thanks for taking the time and offering your other suggestions.  I will 
incorporate them into the next revision.

> Morbus Iff
> Previous comments:
> ------------------------------------------------------------------------
> March 11, 2005 - 08:33 : nysus
> Attachment: http://drupal.org/files/issues/forum_7.patch (2.45 KB)
> Here's some more langauge improvements to the forum help text in the
> forum_help() function for the following Drupal pages:
> 'admin/forum': Got rid of technical jargon and improved readability and
> flow of sentences.
> 'admin/forum/add/container': added a concrete example for additional
> clarification
> 'admin/forum/add/forum': Got rid of technical jargo, improved
> readability and flow of sentences, added a  concrete example for
> additional clarification.

More information about the drupal-devel mailing list