[GitHub Issues](https://docs.github.com/en/issues/tracking-your-work-with-issues/quickstart) allow you to make suggestions and track to dos for a GitHub repository.
## How to write a good GitHub Issue
1. First and foremost, search to make sure that a similar issue doesn't already exist.
2. Each new issue should be discrete.
3. Use an issue template if available, otherwise **Open a blank issue**.
4. Provide a clear and concise title that describes the issue in a way that is easy to understand and allows us to reference the issue easily.
5. A user story is a useful format for writing issues.
6. Provide a detailed explanation of the issue. The type of issue (bug, feature request, or other issue) will dictate the elements to include in your description (see more below).
Here's a simple example
> [!Example] Example GitHub Issue
> ### Description
> After the recent upgrade to `gql==4.0.0`, a call to `mm.get_transactions` in the current version of `monarchmoney` (v0.1.15) raises:
>
> ```
> TypeError: Client.execute_async() missing 1 required positional argument: 'request'
> ```
>
> ### Steps to Reproduce
> ```python
> import asyncio
> from monarchmoney import MonarchMoney
>
> async def main():
> mm = MonarchMoney()
> await mm.login("
[email protected]", "password")
> await mm.get_transactions(start_date="2024-01-01", end_date="2024-12-31")
>
> asyncio.run(main())
> ```
>
> ### Environment
> - monarchmoney==0.1.15
> - gql==4.0.0 (breaks)
> - gql==3.4.1 (works)
> - Python 3.10.19
> - OS: Linux (Arch)
>
> ### Expected behavior
> Transactions should download successfully with `gql>=4.0`.
>
> ### Notes
> Downgrading `gql to <3.5.0` resolves the issue.
>
> Thanks for maintaining this package — it’s super useful!
> [!tip]- Additional Resources
>- [TilburgScienceHub Write GitHub Issues That Get the Job Done](https://tilburgsciencehub.com/topics/automation/version-control/start-git/write-good-issues/)
>- [Dev Community: How to Write a Good Issue](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443)
>- [NYCPlanning Tech: Writing a proper GitHub Issue](https://medium.com/nyc-planning-digital/writing-a-proper-github-issue-97427d62a20f)
>