# contributing to undesktop
thanks for checking out undesktop!
this file explains how to report bugs, request features, and send pull requests.
---
## reporting bugs
if you run into a bug, please open an issue with:
* your operating system (windows/macOS/linux and version if possible)
* the undesktop version (`undesktop --version`)
* the exact command you used
* the full error output
* command output from `--dry-run`
clear and reproducible info makes fixing bugs way easier.
---
## feature requests
if you have an idea or improvement:
* explain the problem you're trying to solve
* describe how you think undesktop should behave
* include examples if possible
this helps us understand your use case and decide if it fits the project.
---
## pull requests
pull requests are welcome! before you submit one:
1. make sure undesktop builds and your change works
2. keep changes focused and easy to review
3. update documentation if behavior changes
4. make sure your code (if any) is organized, readable, and follows the existing style/format of the codebase, and add documentation where needed.
if you're unsure about something, open an issue first so we can talk about it.
---
## etiquette
we want undesktop to be friendly and respectful. be patient if replies take some time, and keep discussion focused and polite — everyone's here to help.
thanks again for your interest! <3