mirror of
https://github.com/outbackdingo/UltraGrid.git
synced 2026-03-20 21:40:15 +00:00
67 lines
2.3 KiB
Markdown
67 lines
2.3 KiB
Markdown
# How to contribute to UltraGrid
|
|
First, thanks to contribute to UltraGrid by using UltraGrid, reporting bugs,
|
|
adding code or ideas. Further section contains basic informations how to
|
|
contribute. Feel free to inform us if you need to contribute in a different
|
|
way or extend this document.
|
|
|
|
## Table of contents
|
|
- [Resources](#resources)
|
|
- [Reporting bugs](#reporting-bugs)
|
|
- [Feature requests](#feature-requests)
|
|
- [Coding standards](#coding-standards)
|
|
* [Indenting and whitespaces](#indenting-and-whitespaces)
|
|
* [Control structures](#control-structures)
|
|
* [Spaces](#spaces)
|
|
* [Line length and wrapping](#line-length-and-wrapping)
|
|
* [Naming conventions](#naming-conventions)
|
|
- [Conclusion](#conclusion)
|
|
|
|
## Resources
|
|
|
|
- [Adding modules HOWTO](doc/ADDING-MODULES.md)
|
|
- [Doxygen](https://frakira.fi.muni.cz/~xpulec/ultragrid-doxygen/html/)
|
|
- [GitHub devel page](https://github.com/CESNET/UltraGrid/wiki/Developer-Documentation)
|
|
- [Trello board](https://trello.com/b/PjZW4sas/ultragrid-development) tracking the development
|
|
|
|
## Reporting bugs
|
|
You can either fill an issue at GitHub or contact our development team directly
|
|
with the e-mail or use a chat. If you suspect that the issue may not be always
|
|
replicable, you can use a script `ultragrid-bugreport-collect.sh` to collect
|
|
data about a computer and attach its result. See also [here](doc/REPORTING-BUGS.md).
|
|
|
|
For general questions, ideas or remarks you are encountered to use the project's
|
|
[GitHub Discussions](https://github.com/CESNET/UltraGrid/discussions).
|
|
|
|
## Feature requests
|
|
Feature requests can be submitted with the same channels as bugs.
|
|
|
|
## Coding standards
|
|
**TODO:** incomplete
|
|
|
|
### Indenting and whitespaces
|
|
- Default indent is 8 spaces width and consists solely of spaces, no tabs.
|
|
- Lines should be LF-terminated and there should not contain any whitespaces at the end.
|
|
|
|
### Control structures
|
|
Control structures like if, while, switch etc. should have opening block bracket at the
|
|
same line as the statement itself:
|
|
```
|
|
if (foo) {
|
|
do_something();
|
|
} else {
|
|
do_something_else();
|
|
}
|
|
```
|
|
|
|
Functions and methods, on the other hand, should have opening curly braces at
|
|
the following line.
|
|
|
|
### Spaces
|
|
### Line length and wrapping
|
|
### Naming conventions
|
|
|
|
## Conclusion
|
|
Aside of what is enumerated above, we will be glad if you share with us your
|
|
setup, photos or just ideas.
|
|
|