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

nysus drupal-devel at drupal.org
Sat Mar 12 15:07:51 UTC 2005

Issue status update for http://drupal.org/node/18732

 Project:      Drupal
 Version:      cvs
 Component:    forum.module
 Category:     feature requests
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  nysus
 Updated by:   nysus
 Status:       patch

After some thought, most of these changes were made.  However, I kept
the two paragraph structure and surrounded each paragraph with >p>>/p>
tags.  The paragraphs cover quite quite different main ideas and I
think it's helpful to convey this to users by indicating such with
two-paragraph structure.


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
'admin/forum/add/forum': Got rid of technical jargo, improved
readability and flow of sentences, added a  concrete example for
additional clarification.


March 11, 2005 - 09:08 : Morbus Iff

I'm on the fence so I have to -1. I'd +1 it with some of the revisions
* 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). 
* You use [p /]. That's bad HTML. A [p] is a container tag, and thus,
should really contain something. I'd revise the text to be just one
paragraph, as I'm not really a fan of [br /][br /] either.
* "To delete a forum or container choose the appropriate "edit"
operation." requires a comma.
* You didn't do a spellcheck. What's "apporpriate"?
* For add/container, it's either "fora" or "forums". "Forum" is not an
adequate plural in this context.
* I'd include the word "root" in quotes to distinguish that it's a
"term" the user may not be familiar with.
* I don't like the use of the word "many". It's extraneous, not
finitely defined, and ultimately garbage.
* I don't like the use of "something in common". I may just want a
place for people to create crap without interfering with the front page
of my site. "Miscellany" or "potpourri" is not "something in common".
The use of "similar" in the original text is stronger, and your "For
example" removes the need for "something in common".
* What's a "forum area"?

More information about the drupal-devel mailing list