How to Ask a Good Question?

Good questions get good answers. Here’s how to make your question clear, answerable, and helpful to the community:

1. Check First

  • Make sure your question is on-topic (developer-focused, about Maya solutions/integrations).
  • Search the forum and review the Maya Developer Hub to see if your issue is already answered.

2. Write a Strong Title

  • Summarize your problem in one sentence.
  • Include key APIs, error codes, or context.
  • Avoid tags in the title — tags belong in the tag field.

Think of it like explaining the issue to a busy colleague: “Integration fails with 401 Unauthorized using Checkout API in Sandbox” is better than “Need help!”.

3. Explain the Problem Clearly

  • Start with a brief description of what you’re trying to achieve.
  • Explain how you encountered the issue and what you’ve already tried.
  • Give context before showing code.

4. Share Minimal, Reproducible Code

  • Include just enough code for others to reproduce the problem.
  • Remove unrelated details (and never post your full project).
  • Don’t upload images of code or errors — copy the text directly.

5. Tag It Properly

  • Add tags for APIs, SDKs, or tools used (e.g., checkout, vault, webhooks).
  • Read tag descriptions to make sure they’re relevant.

6. Proofread Before Posting

  • Re-read your title and body to ensure clarity.
  • Check grammar and formatting.
  • Pretend you’re seeing it for the first time — does it make sense?

7. Stay Engaged After Posting

  • Monitor your thread for comments.
  • Edit your question if more details are requested.
  • Try suggested answers and give feedback.
  • Mark helpful answers as “Accepted” to guide future developers.