A good diagnostic report shortens a support conversation considerably. It should contain enough to reproduce the problem and nothing more.

Include

  • What you were trying to do, in one or two sentences
  • What you expected to happen
  • What actually happened, including any exact error text
  • The steps that reproduce it
  • Your product and version, and your macOS version or browser

Remove first

Never send

  • Passwords of any kind
  • OAuth tokens or refresh tokens
  • API keys or secret keys
  • Full payment card numbers
  • Unredacted customer documents

Related articles