# Defect Management

When a defect is picked up during the smoke or regression testing phase, an issue is reported in GitHub following a bug reporting template found [here](https://github.com/ushahidi/platform/issues/new?template=Bug_report.md).

The following information is captured in the report.

* Title - short description of what the issue is. Anyone reading the title should be able to tell what the issue is.
* Describe the bug - more details on what the issue is.
* Expected Behavior - what should have happened.
* Actual behavior - what actually happened. This needs to be a very accurate and detailed description of the behavior experienced.
* Steps to reproduce - actions followed when bug was discovered.
* Environment - Client used, version number
* Operating System
* Additional Information. Could be logs, screenshots, urls.

Before reporting an issue, take the time to look through the [current issues](https://github.com/ushahidi/platform/issues) and make sure it has not been reported. If it hasn’t been reported, proceed to creating a new issue.

TestPad has a feature that allows you to comment on any failure. Here you can leave a brief of why a test failed, including screenshots. If an issue is created on GitHub from this failure, you can leave a link to the issue in the comment section for easier tracking.

\*\*\*\*


---

# 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.ushahidi.com/platform-developer-documentation/dev-legacy-v3/qa-and-testing/defect-management.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.