Introduction

Thank you for your interest in DZGUI!

This guide goes over development conventions and best practices for contributors. If you are a developer, you can skip to the end.

Requesting help

If you encounter a problem with DZGUI, you can submit tickets on the GitHub issue tracker under the troubleshooting tag.

How can I help the project?

There are several ways to help this project.

Report bugs that you find
Request features that you would like
Contribute features and fixes to the codebase
Contribute documentation to the project

Before making any contribution, please read the CODE_OF_CONDUCT.md and act accordingly.

Submitting a ticket

Navigate to the GitHub issue tracker. From there, follow the onscreen prompts. You will be asked questions such as:

What version are you using?
What distribution are you using?
What is the issue that you found?
How can we reproduce the issue?

You can also attach screenshots, logs, or other data that can help us.

Requesting a feature

You can also request features via the same issue tracker. It is good practice to first search for your idea to see if a similar one has already been posted. If not, open a ticket where you describe your feature and its possible benefits.

Please note that this is a community project, so it takes time for us to develop features. Putting in a feature request does not mean that it will be implemented, but we will do our best to support as many cool ideas as possible.

Contributing code or documentation

If you would like to assist with an issue on the issue tracker or contribute a new change, please follow the guidelines below.

Fork this repository and check out the code up to the dzgui7 (development) branch.

The following naming conventions apply for PRs:

fix/ - patch/hotfix branches
feat/ - feature branches
doc/ - documentation branches
infra/ - infrastructure branches

Implement your changes and test them locally. If they work, you may open a merge request, and then we review your changes. If everything is OK, it will be merged to dzgui7. After sufficient changes are consolidated into a new release, this branch will be tagged to a certain point in time and a binary release published.

It is recommended to follow Conventional Commits, as this integrates well with tooling and helps the project review your code.

Please see DEVELOPERS.md for further details.

License applicability to contributions

Code contributed to this repository becomes subject to the terms of the GPL license defined in the LICENSE file at the project root.

2.7 KiB Raw Blame History