# How to write a bug report

We don’t like bugs, neither you do. I’ve seen a post in [jetpack blog](http://jetpack.me/2011/11/18/how-to-write-a-great-bug-report/) talking about this and I’ve found really interesting. I’m going to reproduce it here:

{% hint style="success" %}
Here’s a great rule: **If we can’t reproduce the bug, we can’t fix the bug.**
{% endhint %}

**When you report a bug to us, here’s what happens:**

* We read the bug report
* One of us tries to reproduce the bug
* If we can reproduce it, we investigate what’s broken and fix it
* But if we can’t reproduce the bug…
* Often bug reports don’t include enough information. Meaning we have go back and ask for details so we can investigate. If you want to increase the odds we fix an issue, and fix it fast, help us out.

**A great bug report includes the following:**

1. What were you trying to do?
2. What did you click on or do last?
3. What happened / what did you see?
4. What browser are you using?
5. What version of OSClass?
6. What hosting provider? (And if you know, what version of PHP do they use?)
7. The bug is reported to the right place:
   1. [**OSClass**](https://github.com/mindstellar/osclass/issues)
   2. **Plugins:** Specify the plugin and the version
   3. **Themes:** Specify the theme and the version

Bug reports that [**show screenshots**](http://take-a-screenshot.org/) for #3 are incredibly useful, as we can see exactly what you saw.

{% hint style="info" %}
**Bonus points** for reviewing known issues before submitting, as your problem might already have been reported and have a patch or a workaround.
{% endhint %}

We work hard to have you deal with as few issues as possible, but if you want to improve the odds we can fix your issue fast, please take a extra minute to write a bug report that’s easier for us to use. Thanks.

Source: [How to write a great bug report](http://jetpack.me/2011/11/18/how-to-write-a-great-bug-report/)


---

# 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.mindstellar.com/osclass-docs/developers/basic-osclass/how-to-write-a-bug-report.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.