Thank you for taking an interest in collaborating with us on the rollyourown project!
Code and content of the rollyourown project is stored in our public repositories and collaboration is organised around these. We use the Issue tracking features to raise, discuss and track ideas, feature requests and bugs. We use forking and pull requests to manage changes to code and content.
We would be delighted if you would like to contribute and there are a number of ways you can collaborate on the project.
If you have found a security vulnerability in any rollyourown service or any of the rollyourown projects, modules or other repositories, please report it via our security vulnerability report form.
For more information, see our guide for raising security vulnerabilities.
Report a bug or suggest an improvement for this project via the Issues. Before submitting an issue, please search the existing issues in case the topic has already been addressed.
In case of general feedback and ideas for rollyourown that are not specific to this or a different project or module, please use the Issues in the general feedback repository on Codeberg or on GitHub.
Feedback to a different project or module should be submitted in the applicable repository.
For more information, see our guide to contributing bug reports, feature requests and ideas.
If you would like to improve the code yourself, please first submit an Issue describing what you would like to change and why.
The project maintainer can then provide feedback on the proposal in advance of you doing any work. There may be a reason why your proposal would not be accepted, or should be realised differently, so this avoids you doing work which will end up not being accepted and merged into the code.
If, after discussing the change, you would like to proceed and implement it, then please fork this repository and submit a Pull Request. Please follow the workflow described on our website in our guide to Forking and Pull Requests.
We use Software Package Data Exchange (SPDX) licensing and copyright information in each source file in our repositories. We request any contributor to add SPDX information to any new file submitted and to include additional copyright information in modified files, where applicable.
In addition, when submitting a Pull Request to our project we ask contributors to agree with the terms of the Developer Certificate of Origin (DCO) to certify that the contributor has the right to make the contribution to our project. As well as ticking the checkbox in the Pull Request template, we recommend signing off each commit. To do this, configure your Git username and email address for the repository with:
git config user.name "<USERNAME>"
git config user.email "<EMAIL ADDRESS>"or globally with:
git config --global user.name "<USERNAME>"
git config --global user.email "<EMAIL ADDRESS>"Signoff is then automatic when using the -s flag with the git commit command.