# How to file issues

Simpler.Grants.gov uses GitHub as our primary work tracker. If you encounter bugs, have feature requests, or want to provide feedback, filing an issue on GitHub is the way to go. This guide will help you understand how to file issues and contribute to improving our projects.

## Getting Started

Make sure that all issues follow the Simpler.Grants.gov [Code of Conduct](/get-involved/policies-and-guidelines/code-of-conduct.md). We understand that experiencing issues with software can be frustrating, especially when it prevents you from doing work. However, please remember that a human on the other side will be reading your issue and responding to it.

### 1. Navigate to Issues

* Go to the repository on GitHub where you want to file the issue.

### 2. Click on "Issues"

* Click on the "Issues" tab at the top of the repository to view existing issues or file a new one.

### 3. Check Existing Issues

* Before filing a new issue, check if a similar issue has already been reported.
* If you find a similar issue, instead of creating a new one, react to the existing one with a thumbs up and comment if you have any additional insights.

## Filing a New Issue

### 1. Click on "New Issue"

* Click the green "New Issue" button to create a new issue.

### 2. Choose Issue Template (if available)

* Some repositories may provide issue templates to help standardize the information provided.
* Choose the appropriate template.

<table><thead><tr><th width="298">Type</th><th>Details</th></tr></thead><tbody><tr><td><a href="/pages/eafFHFErpn0AZlfFcosi"><strong>Bug Report</strong></a></td><td>Used for filing reports of existing features in the software not working as expected</td></tr><tr><td><a href="/pages/WlGLR3vETYTIPwwlsQVJ"><strong>Feature Request</strong></a></td><td>Used for creating a request to add a feature that is currently not supported within the software</td></tr><tr><td><a href="/pages/8gbNak0xLW1QrT9VeIJv"><strong>Report a security vulnerability</strong></a></td><td>Used to report a software security issue that you have noticed.</td></tr></tbody></table>

### 3. Submit the Issue

* Once you've filled out all the necessary information, click the "Submit new issue" button to create the issue.
* We will review the issue and prioritize it within the Simpler Grants Community. We may not respond immediately or directly to you, but we review all issues and appreciate your participation and patience.

## Tips for Filing Issues

* Be descriptive: Provide as much information as possible to help developers understand and address the issue.
* Search first: Before filing a new issue, search existing issues to avoid duplicates.
* Follow guidelines: If the repository has specific guidelines or templates for filing issues, follow them for consistency.

## Change log

Major updates to the content of this page will be added here.

<table><thead><tr><th width="220">Date</th><th width="227">Update</th><th>Notes</th></tr></thead><tbody><tr><td>2/12/2024</td><td>Initial Content</td><td>Updated with Initial content</td></tr><tr><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td></tr></tbody></table>


---

# 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://wiki.simpler.grants.gov/get-involved/github-planning.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.