Closed (fixed)
Project:
Documentation
Component:
Misc
Priority:
Normal
Category:
Task
Assigned:
Reporter:
Created:
24 Oct 2005 at 01:37 UTC
Updated:
27 Mar 2006 at 22:08 UTC
Jump to comment: Most recent file
Attached is a set of tips for posting to the Drupal forums, documentation that could be included in the About Drupal handbook.
Please give your feedback on whether
* these are necessary (do we need this type of document?)
* any other items that I might include in this list
| Comment | File | Size | Author |
|---|---|---|---|
| #4 | drupal-forums-tips3.html | 2.99 KB | webchick |
| #3 | drupal-forum-tips2.html | 2.99 KB | cel4145 |
| #1 | drupal-forum-tips.html | 2.71 KB | cel4145 |
| drupal -forum-tips.html | 2.7 KB | cel4145 |
Comments
Comment #1
cel4145 commentedsorry. the file name was broken on the last attachment.
Comment #2
nevets commentedIt could be very useful, the one thing I would add is a note about people enabling their contact tab, people often ask questions that are better answered off line but do not have the contact enabled.
Comment #3
cel4145 commentedgood advice. see if what i added does what you want.
Comment #4
webchickLooks good. I like that it stresses the point about Drupal being a volunteer community and that people can get involved themselves, as well as the point about Drupal being an international community and that sometimes users can come across as abrasive or rude because of a language barrier.
I've attached a new version that just fixes a couple minor spelling things.
Comment #5
cel4145 commentedThanks!
I went ahead and posted it into the handbook: Tips for posting to the Drupal forums. Any other feedback and I can update it there.
Should I add a link in the forum posting instructions that appear on node/add/forum?
Comment #6
Bèr Kessels commentedI think you should remove the centre paragraph of the /node/add/forum and replace it with the 6 bullets. That, and a link to the handbookis a very good thing IMO. People hardly read a lot of text, but do read bullets. If they are interested they will read further, i think.
Ber
Comment #7
cel4145 commentedI understand what you mean. But I'd be hesitant to include all that text in node/add/forum because of usability concerns. Though I wonder if it would work to just include the following bullets with a note and link to the full text version:
* Context-sensitive forum post titles.
* Detailed specifics.
* Ignore flames and rude tones.
* You get more bees with honey than with vinegar.
* With volunteer support, not everyone gets a response.
* Enable your contact tab.
These could also be revised so that they become clearer when separate from the larger explanations yet still remain short. Perhaps,
* Use context-sensitive forum post titles.
* Include detailed specifics.
* Ignore flames and rude tones.
* Be polite.
* With volunteer support, not everyone gets a response.
* Enable your contact tab.
Comment #8
webchickI would maybe do:
* Please [search] (link to search) and check the [handbook] (link to handbook) before posting.
* Please use descriptive titles -- this allows people to better assist you.
* Include detailed specifics -- Drupal version number, specific error messages, steps you've tried, and so on.
* Ignore flames and rude tones -- remember that English is not everyone's first language.
* Be polite -- you are more likely to get a helpful response.
* Remember that with volunteer support, not everyone gets a response -- please do what you can to help out!
* Enable your contact tab -- this allows people to contact you outside of the forums if required.
This is still not *too* wordy, but expands on the points more than just the bullets themselves. I also changed "context-sensitive" to "descriptive" titles, because the former is a bit unclear, imo. And I added a bullet point for the search and handbook, per Boris's comment.
Comment #9
sepeck commentedIt needs to be top level in the handbook. (maybe use blink tags or highlight it red or something)
Some suggestions, a new section starting.
We need an introduction to the community. I have started an attempt at one, but as I got into it, I realized I was writing an introduction to the handbook (not a bad thing, just got distracted and missed my target).
Perhaps something along the lines of...
Comment #10
sepeck commentedLet's try it without a missing quote in a an href tag.
Comment #11
cel4145 commented" I realized I was writing an introduction to the handbook (not a bad thing, just got distracted and missed my target)."
No, I imagine you were right. IMHO, the whole About book needs to be reorganized and revised. It just doesn't work well as a text that leads new people through where they need to go (I have trouble finding stuff in it), and, as I think we have seen lately with the anti-Drupal sentiments in the forums, it needs additional information that helps people to make better decisions about Drupal and understand what Drupal is all about. This is something I had hoped to take on in about two or three months.
In the meantime, I'm all in favor of you doing what you think you need to do as long as some others agree. It may be better to start a new issue since many may now be ignoring this one.
Comment #12
ryooki commentedI would change the italics to bold as the italics seem to disappear in the text, but I guess that's just personal preference. What about including something related to searching the issues / feature / support requests of contributed modules, and how to do that properly? I think also including info on how to use blockquote, code, and ?php would also be helpful.
Comment #13
cel4145 commented"What about including something related to searching the issues / feature / support requests of contributed modules, and how to do that properly? I think also including info on how to use blockquote, code, and ?php would also be helpful."
My original goal for this document was that is something someone would use once they had decided to post in the forums. So it should link from other pages where that information has already been suggested, such as here:
http://drupal.org/support
The other information on encoding would turn this into more of an instructional document, rather than a general guide for how to communicate effectively. Perhaps that would work well as a sub-page? I'd definitely say add one if you want? Perhaps another subpage that provides detailed information on searching the forums (as well as how to use Google to do so).
Comment #14
cel4145 commentedWebchick-Sorry I'm just responding to your suggestion. A few thoughts:
- I don't think that "descriptive titles" works well. "Please help. Newbie in big trouble" is very decriptive to some people (lol). Perhaps "detailed, context-specific" titles" or "descriptive, context-specific titles?
- as I mentioned above, I see this page as about how to communicate well in the forums, with the assumption that this page will be linked from other areas that say to search first.
- the problem I could see with those much longer bullets is that they are not scannable in the full text version. so we'd have a different set of bullets in node/add/forum, and the language would be different, making it slightly less usable.
Then again, I could be wrong about all this :)
Comment #15
sepeck commentedOk. I will review and edit my idea a bit this week and get it added at the top of the About Drupal page.
Change the
<strong>to<em>as well.I will open another issue on it in the next day. Where the 'sub' links are is not important. Links from this page to them would work just as well as sub pages. I just think we need it to A. Point people to and B. help set their expectations per your idea.
Comment #16
sepeck commentedOh the heck with it, http://drupal.org/node/35172 I posted it. Review/edit as needed. I figured we needed something sooner than later as a start.
Comment #17
cel4145 commentedOkay. I edited. Add in some commas, a little more information, and refined some sentences. Changed the tone a little, too, (the part about discussions and being civil). Someone else jump in and review/edit it further :)
Comment #18
sepeck commentedso I should use more words in the future? :)
Comment #19
ezheidtmann commentedSome comments:
The italicized phrase "what you get out of it depends on what you put into it" looses some punch because of what follows it. I think if you end the sentence right there (omitting "and your current skills") it will read much better.
Later in that same paragraph, "familier" should be "familiar."
In the last paragraph, "... then contributors" should be "... than contributors"
I would remove the first sentence of the last paragraph and make a number of other changes, so it would read
If you want to mention revising and writing handbook pages here, add a link to a page describing how to do that.
Comment #20
ezheidtmann commentedAlso, I think the link "Developers Guide" should read "Developer's Guide".
Comment #21
cel4145 commentedUpdated. Except I changed "handbooks" to plural.
Comment #22
sepeck commentedclosing.