-
Notifications
You must be signed in to change notification settings - Fork 807
What we look for when reviewing and merging pull requests
Change for the sake of change is never a good thing! When submitting a pull request, please provide good reasoning for your changes. This will make it much more likely for reviewers to eventually approve your PR.
An explanation of what your PR changes will make the lives of reviewers much easier. We don't need you to write extensive documentation about your changes, but a basic overview will be much appreciated.
It is often very difficult to tell what has been changed visually just by looking at the code. If you are modifying any of the UI components of the desktop client, please provide a screenshot!
The designers are the most knowledgeable regarding what makes a user interface usable, accessible, and attractive. Whenever a change is made to the UI, we always seek the feedback of the designers.
If your pull request is marked as a draft, it is likely to be deprioritised over PRs that are ready. Once you are finished making changes to your pull request, and it is ready for review, make sure to mark it as ready!
Nextcloud's desktop client team follows coding style guidelines that make our code readable and maintainable. Please ensure that your code conforms to these guidelines.
Testing is an essential part of ensuring the continued stability of the desktop client, and it is mandatory that new code does not break existing tests and CI pipelines.
Unit tests are not always a required addition to a PR, but their inclusion will always accelerate and improve the review process.
The Nextcloud community has a code of conduct that we expect all community members to follow. Breaking the code of conduct at any stage of the PR submission or review process will stop us from approving it.
All new code merges for the desktop client require at least two members of the desktop client team to approve the changes. This helps us ensure that new code is stable and efficient.
Good luck with your pull request!