# Contributing

:material-heart: Thank you for your interest in contributing to releasio!

---

## Overview

We welcome contributions of all kinds:

- Bug reports and feature requests
- Documentation improvements
- Code contributions
- Testing and feedback

---

## Getting Started

<div class="grid cards" markdown>

-   :material-cog:{ .lg .middle } **Development Setup**

    ---

    Set up your development environment

    [:octicons-arrow-right-24: Setup Guide](setup.md)

-   :material-github:{ .lg .middle } **GitHub Issues**

    ---

    Report bugs or request features

    [:octicons-arrow-right-24: Open an Issue](https://github.com/mikeleppane/releasio/issues)

</div>

---

## Ways to Contribute

### Report Bugs

Found a bug? Please open an issue with:

- Clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Version information (`releasio --version`)

### Suggest Features

Have an idea? Open an issue with:

- Description of the feature
- Use case / motivation
- Potential implementation approach

### Improve Documentation

Documentation improvements are always welcome:

- Fix typos or clarify wording
- Add examples or tutorials
- Improve API documentation

### Submit Code

Ready to code? See the [Development Setup](setup.md) guide.

---

## Code of Conduct

Please be respectful and constructive in all interactions. We're all here to build great software together.

---

## License

By contributing, you agree that your contributions will be licensed under the MIT License.
