Skip to main content

How to Provide Helpful Feedback and Bug Reports

These steps will help us fix bugs faster and create more useful features based on your feedback.

Written by Skyler Young
Updated over a month ago

When you report a bug or share feedback, a few simple details can make a big difference in how quickly we can help.

Reporting Bugs

Start with the URL

The Connect 211 directory is “deep-linked,” meaning the page you’re viewing is encoded in the URL. Including that link helps us see exactly what you’re seeing.

Add steps to reproduce

For bugs, the most important thing to include is a short list of steps we can follow to reproduce the issue. Numbered steps work best. If we can reproduce the problem, we can usually fix it quickly.

Example:

  1. Go to [URL]

  2. Click on “Search”

  3. Enter “housing”

  4. See the error message

Include screenshots when possible

A screenshot can help clarify what’s happening, especially if something looks off or behaves unexpectedly.

General feedback

If your feedback isn’t a specific bug, try to be as clear as possible about what you expected and what actually happened. If you’re suggesting a new feature, describe the steps you’d like to take and the result you’re hoping for. This helps us understand your perspective and build solutions that match your needs.

Reference material will help us turn your feedback into features faster:

  1. Document the steps you would like to take, and what you expect the result to be.

  2. If possible, include pictures, graphics, or outlines.

  3. Links to other apps or websites that have the feature you want are helpful.

Summary

Documenting your user experience in a list and including visual reference material (including URLs) helps us respond to your feedback and bug reports much more quickly.

Thanks for taking the time to share feedback. It directly helps us improve the experience for everyone.

Did this answer your question?