How to Ask a Good Question

Document created by Adam Arrowsmith Employee on Apr 28, 2016Last modified by Adam Arrowsmith Employee on Feb 27, 2018
Version 4Show Document
  • View in full screen mode

Asking a good question is the first step to receiving a good answer. Here are some tips for what to ask and how to ask it.


Step 1: Is my question appropriate for the community

First, be sure the question is appropriate for the community:


Forums are a great place to discuss...

Forums are NOT a great place to discuss...

  • Integration and process design advice from peers
  • Implementation recommendations and best practices
  • Advice on integrating with specific applications
  • Common errors
  • Tips and tricks
  • Urgent/severe support issues like “production down”
  • Account-specific questions related to your subscription
  • Problems requiring extensive troubleshooting and configuration analysis
  • Account- or customer-specific data including process URLs, AtomSphere Account IDs, user names, passwords, emails, phone numbers, etc.
  • Selling your business or consulting services


Step 2: Search before you ask

Has your question already been answered? Or maybe there's another article, idea, or blog addresses the topic.

  • Use the Global Search (magnifying glass in the upper right corner)
  • Use the Ask a Question search box to see what already exists.
  • Try different keywords in case the question was asked slightly differently.


Step 3: How to ask it

Now that you know you have an appropriate and novel question, here are some tips for what to include in your question and how to ask it so other members are able to help.

  1. Include some basic information such as:
    • Do you have an error or looking for design or configuration advice?
    • What are you trying to do? What's your overall objective?
    • How do you have it configured currently?
    • What is happening (good, bad, or otherwise)?
    • Include relevant details about the scenario or runtime environment. Are there notable constraints or assumptions you're working with?
  2. Be clear about your overall objective up front. "Progressive disclosure" of your scenario ("How to I do X?...thanks but what I REALLY want to do is Y...") can lead to unnecessary backtracking. Letting others know the ultimate goal can result in a better suggestion sooner.
  3. Do your homework first. What have you tried or found in researching the issue so far? Not only does this avoid receiving answers you've already dismissed but it builds goodwill with your peers.
  4. If you're asking about an error, include the full error message. Copy and paste the error text (full stacktrace when available) instead of a screen shot of an error message.
  5. Screen shots are a great way to describe process, shape, and component configuration. Take care to mask any sensitive details like host names, user names, email addresses, etc.
  6. Processes can get very large and complex sometimes. When possible try to isolate the problem first and create a simple representative test case. What's the minimal amount of configuration that still reproduces the behavior? In other words, avoid posting a screen shot of a process with 50 shapes and asking "what's wrong with my process?"
  7. For mapping issues provide samples/snippets of the input, actual output, and desired input data. Again take care to mask any sensitive data in examples.
  8. For complex nested/looping data, create a simplified "conceptual" example of the data that highlights the important logical relationships.
  9. For configuration and design-related questions, share your overall objective or requirement. Very often there are other ways to approach the problem and knowing what you're ultimately trying to accomplish is important.


Share these tips with new users to help improve questions across the community!


See also Creating Questions and Discussions for more information.

10 people found this helpful