How to ask good questions

faq
how-to

#1

You run into a problem or you just can’t figure out how things work. This is where you want to start asking people in our community for help.

Here are some guidelines how to ask good questions where people are more willing to spend time to help you.

Do some research

Where can I ask questions?

  • Asking directly in our chat which requires someone to exactly have time to answer when you ask.
  • Ask questions in our Discourse instance and place the question in a fitting category.

Compose questions in Discourse

  • Use a short and useful subject line. Think it this way, there are probably others with a similar question. Make it easy for them to find it.
  • Tag your message to make it easier for others to find them.
  • Summarise your problem before you going to explain all the details.
  • Try to make a clear description of your problem.
  • Make it easy for others to help you by adding relevant information to your question like:
    • What is the OpenNMS version you run or branch you try to compile?
    • What is your operating system and what version is it?
    • What is the version of your installed Java Development Kit or version of Maven you have running?
    • If you get error messages, add these error messages in your post.
    • Explain which steps have you done to make it easy for others to reproduce your problem.
    • What have you done so far to fix the problem, what have you searched in the internet?

You asked your question, now what?

  • Be patient, people live in different time zones have work- and family life.
  • If you don’t get response it can be, the answer is unknown, or your question was not understood. Posting an amended question could produce a better result.
  • Your problem is solved, please post back to the community if the suggested solutions worked (or not). If you find a solution please share with others.

Try to avoid the following things

  • Avoid cross-postings with asking the same questions in multiple categories
  • Don’t scream at us using ALL CAPITALS, it is just hard to read
  • Avoid poor subject lines like:
    • HEEEELLLLLLLPPPPPPPPP!!!
    • any experts around here?
    • <Name of person> EMAIL ME!!!
    • need help please
    • it does not work
    • too much XML

Kudos to a very old article Good Post which was used to write this article.