ffplayout/CONTRIBUTING.md

46 lines
2.4 KiB
Markdown
Raw Normal View History

2022-08-30 16:48:40 -04:00
## Contribute to ffplayout
2024-03-21 05:23:20 -04:00
### Report a bug
2022-08-30 16:48:40 -04:00
- Check issues if the bug was already reported.
- When this bug was not reported, please use the **bug report** template.
* try to fill out every step
* use code blocks for config, log and command line parameters
* text from config and logging is preferred over screenshots
2024-03-21 05:23:20 -04:00
### Ask for help
2022-08-30 16:48:40 -04:00
2022-11-11 05:40:33 -05:00
When something is not working, you can feel free to ask your question under [discussions](https://github.com/ffplayout/ffplayout/discussions/categories/q-a). But please make some effort, so it makes it more easy to help. Please don't open discussion in a "WhatsApp style", with only one line of text. As a general rule of thumb answer this points:
2022-08-30 16:48:40 -04:00
- what do you want to achieve?
- what have you already tried?
- have you looked at the help documents under [/docs/](/docs)?
- what exactly is not working?
- relevant logging output
- current configuration (ffplayout.yml)
2024-03-21 05:23:20 -04:00
#### Sample files
If playout works normally on your system with the [provided test clips](https://github.com/ffplayout/ffplayout/tree/master/tests/assets/media_sorted), but your files produce errors and you are sure that the problem is related to ffplayout, you can provide a test file under these conditions:
- ffmpeg can process the file normally.
- The file is not too large, a few seconds should be enough.
- The video doesn't contain any illegal content.
- You have legal permission to distribute the file.
- The content is not age restricted (no violent or sexual content).
### Feature request
2022-08-30 16:48:40 -04:00
You can ask for features, but it can not be guaranteed that this will find its way to the code basis. Try to think if your idea is useful for others to and describe it in a understandable way. If your idea is accepted, it can take time until it will be apply. In general stability goes over features, and when just a new version has arrived, it can take time to prove itself in production.
2024-03-21 05:23:20 -04:00
### Create a pull request
2022-08-30 16:48:40 -04:00
In general pull requests are very welcome! But please don't create features, which are to specific and helps only your use case and no one else. If your are not sure, better ask before you start.
Please also follow the code style from this project, and before you create your pull request check your code with:
```BASH
cargo fmt --all -- --check
cargo clippy --all-features --all-targets -- --deny warnings
```
For bigger changes and complied new functions a test is required.