# Support

## GitHub

At `cdl_convert`'s [GitHub page](https://github.com/shidarin/cdl_convert) you can browse the code and the history of the project.

Builds can be downloaded from the GitHub page or the [PyPI repository](https://pypi.org/project/cdl_convert/).

## Bug Reporting

The [issues page](https://github.com/shidarin/cdl_convert/issues) on GitHub is the best place to report bugs or request support. While `cdl_convert` is distributed with no warranty of any kind, issues will be read and helped if able.

### How to Report a Bug

When filing an issue, please include:

1. **Description** - Clear description of the problem
2. **Sample Files** - Attach sample CDL files that demonstrate the issue
3. **Command Output** - Full output from your terminal/shell
4. **Environment** - Python version, OS, cdl_convert version
5. **Expected Behavior** - What you expected to happen
6. **Actual Behavior** - What actually happened

Example:
```
$ cdl_convert --version
cdl_convert 1.0.0

$ cdl_convert input.ccc -o cc
[paste full output here]
```

## Feature Requests

Have an idea for a new feature? [Open an issue](https://github.com/shidarin/cdl_convert/issues/new) on GitHub with:

- Description of the feature
- Use case explaining why it would be useful
- Examples of how it would work
- Sample files if applicable (especially for new format support)

See {doc}`faq` for information about format support requests.

## Contributing

Want to contribute code, documentation, or tests? See {doc}`contributing` for guidelines on:

- Setting up a development environment
- Running tests
- Code style requirements
- Submitting pull requests

## Documentation

- **This Documentation** - You are here. See {doc}`index` for the table of contents
- **Usage Guide** - See {doc}`usage` for command-line examples
- **API Reference** - See {doc}`api/index` for Python API documentation
- **FAQ** - See {doc}`faq` for frequently asked questions
- **Installation** - See {doc}`installation` for installation instructions

## Contact

Support will generally not be given over email, social media, etc. If you need 
support, use the [issues page](https://github.com/shidarin/cdl_convert/issues) 
on GitHub.

That said, if you want to say 'hi' or see what I'm currently working on:

- **Bluesky:** [@shidarin.com](https://bsky.app/profile/shidarin.com)
- **Email:** shidarin@alphamatte.com
- **GitHub:** [@shidarin](https://github.com/shidarin)
- **Blog:** [shidarin.github.io](https://shidarin.github.io/)

## No Warranty

CDL Convert is provided "as is" without warranty of any kind, either expressed or implied. See {doc}`license` for full license terms.