# Reporting Issues and Suggesting Features 💬

Your feedback helps make PANORAMA better! Whether you've found a bug, have an idea for a new feature, or want to suggest
an improvement, we want to hear from you. This guide will show you how to report issues and make suggestions
effectively.

## Reporting a Bug 🐛

Found something that doesn't work as expected? Here's how to report it:

### Before Reporting

1. **Check if it's already reported** - Search the [issue tracker](https://github.com/labgem/PANORAMA/issues) to see if
   someone else has reported the same issue
2. **Make sure it's a bug** - Is this a problem with PANORAMA, or an issue with your input data or environment?
3. **Try to reproduce it** - Can you make the bug happen again with the same steps?

### Creating a Bug Report

Go to the [PANORAMA issue tracker](https://github.com/labgem/PANORAMA/issues/new) and use the provided template.

---

## Suggesting a New Feature 💡

Have an idea to improve PANORAMA? We'd love to hear it!

### Before Suggesting

1. **Check existing features** - Make sure the feature doesn't already exist
2. **Search the issues** - Someone might have already suggested something similar
3. **Think about the use case** - How would this feature be useful to you and others?

### Creating a Feature Request

Go to the [PANORAMA issue tracker](https://github.com/labgem/PANORAMA/issues/new) and use the provided template.

---

## Enhancement Suggestion ✨

Some idea to enhance PANORAMA? [Tell us about it!](https://github.com/labgem/PANORAMA/issues/new) with the
`enhancement` issue template.

---

## Asking Questions or Sharing Ideas 💭

Not sure if something is a bug or feature request? Just want to discuss an idea? 
Create a [Q&A issue](https://github.com/labgem/PANORAMA/issues/new) and share:

- Questions about how PANORAMA works
- Ideas you want to explore before making a formal feature request
- General feedback or suggestions
- Use cases and workflows you'd like to share

```{seealso}
You can also start a new [GitHub Discussions](https://github.com/labgem/PANORAMA/discussions)
```
---

## What Happens Next?

After you submit an issue or discussion:

1. **We'll respond** - Usually within a few days
2. **We might ask questions** - To better understand your issue or idea
3. **We'll label it** - To help organize and prioritize
4. **We'll discuss solutions** - For bugs, or feasibility for features
5. **Someone might work on it** - Could be a maintainer or a contributor (maybe you!)

```{note}
Be patient - we're a small team, but we read every issue and discussion!
```

## Getting Help 🆘

If you're not sure how to report something or have questions:

- Read the [documentation](#reporting-issues-and-suggesting-features) (maybe it's already there)
- Ask in [GitHub Discussions](https://github.com/labgem/PANORAMA/discussions)
- Open an issue anyway - we'll help you refine it!

Thank you for helping improve PANORAMA! Your feedback makes the tool better for everyone. 🙏