# Customer support

## How to handle common issues

Praveen Kumar at WHO India has compiled an excellent guide on what program officers should do when healthcare workers encounter issues using Simple:

✋🏽​ [What surveillance officers should do when they encounter a bug or issue with the Simple app](https://docs.google.com/document/d/1RgWCn-gcXvEbnozAZPIqmVpdQrd_INYFNOKB0NBGpII/edit#heading=h.jymexnipl7j2)

## How to report an issue

If you use Simple in the field and want to help the tech teams behind Simple with useful bug reports, please reference this helpful guide on how to triage and document issues:

🐞 [How to file a bug report or raise an issue](https://docs.google.com/document/d/1bJniRgJL8ef_SWWcwdLi1WASlez0ZHLH556YRDA9mDE/edit#heading=h.hucspecdvz3q)

## File an "Issue" on Github

{% hint style="info" %}
To report a bug, please create an "Issue" on Github. If you don't know what that means, please just email a bug report to <team@simple.org> with as much information as you can, so we can understand what's happening. Thank you.
{% endhint %}

📱 File a bug about [the Android app](https://github.com/simpledotorg/simple-android/issues)

🖥️ File a bug about [the web-based Dashboard](https://github.com/simpledotorg/simple-server/issues)

## Filing a useful bug report on Github

1. Click on *New issue*
2. Define the bug succinctly in the title.\
   For example: *App freezes when user clicks 'Register as new patient'*
3. In the description, record steps to reproduce the bug.
   1. On the home page, add patient's name, click "Next"
   2. On the next screen, click "Register as new patient"
   3. Behaviour: App freezes
   4. Expected behaviour: Redirect to page where other patient details are requested
4. Don't forget to label your issue `Bug`

### Additional information, if possible

* Attach screenshots as supporting documentation
* Include the app version, device model and Android version in the description
* For bugs on the Simple Dashboard, include browser and version


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.simple.org/contact/support.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.