The goal of this document is to set standards for the review, processing, and approval of all Pull requests into the DNN_Platform GitHub repository, as well as associated commmunity open-source repositories. These rules apply to ALL pull requests, regardless of the submitter, or complexity of the change.
The following items must all be true prior to a pull request being submitted to the DNN_Platform, if any of the following items are not true the pull request will be returned for edits referencing the specific missing item(s).
- Change should represent an entire solution for the issue at hand. Partial requests will NOT be processed.
- Change should have a supporting issue logged on the DNN_Platform GitHub account, documenting the issue resolved, following the procedures outlined on the Contribute Page
- If your change was to an area that already was covered by tests those tests must be updated. New tests for areas currently un-tested are appreciated
- Exception: Security items can be addressed individually, and should be initially communicated to the security@dnnsoftware.com email address for coordination
- Pull request comment should contain at a minimum the following details (When creating, a default template will also prompt you for the proper information)
- Issue #, referenced such as “Fixes #24”
- Release Note: Suggested release note for the change such as “Improvement of user profile to improve performance when searching.”
- Testing Steps: Suggested testing steps for validation of the change
- Pull request must pass the Continuous Integration (CI) Build. Failure of the build will result in no futher review of the pull request until the build has been corrected.
- The .NET Foundation [Contributor License Agreement (CLA)] (https://cla.dotnetfoundation.org/) must be signed prior to code review. An automated process will prompt for this as part of the Pull Request process.
NOTE: Changes to methods that have been marked as [Obsolete] will typically not be accepted due to inherit risks associated with code scheduled for removal. If a critical bug/issue exists, please be sure to document & discuss using an RFC issue prior to submitting your contribution to ensure alignment with acceptance criteria.
Community review of submitted pull requests is encouraged, and all pull requests must be reviewed by at least two (2) designated approvers before the change can be approved. Once approved by two unique designated approvers, the change can be merged. An approver should NEVER merge their own change, even with two supporting approvals.
At the current time the following community members are designated approvers.
- Mitchel Sellers (mitchelsellers) - Community Technology Advisory Group Lead
- Brian Dukes (bdukes)
- Peter Donker (donker) - Community Developer Advisory Group Lead
- Daniel Valadas (valadas)
- Matt Rutledge (mtrutledge)
- David Poindexter (david-poindexter) - Community Strategy Advisory Group Lead
An individual performing the code review should validate at a minimum the following.
- The source should be able to be cloned, compiled, and all tests ran without error
- The issue identified should no longer be apparent, and testing steps validated
- The change should be free from visible errors, and adherence to recommended best practices should be validated.
- All tests are passing successfully (Confirmed with the automated build)
If a reviewer has suggestions for improvement, those should be noted in the pull request and revision requested. If the pull request is acceptable “as is” simply noting, via a comment, “I reviewed this, no concerns” will document the completion of a review, this statement is preferred to the shorthand LGTM (Looks good to me) for clarity.
If you have questions about a pull request or an idea for a pull request, please reach out to one of the approvers before submitting to ensure a streamlined process.
For proper management of pull requests the team will utilize the "Draft" option within a pull request to identify something that is being submitted for consideration and in need of review/comment or other special review from the team. Individuals should coordinate with the Approvers group prior to submitting any Draft pull requests as they are special cases.
The Approvers group will add the "On-Hold" tag to any pull request that is targeting a major or minor release until it is ready for merging. This is done as an administrative process to prevent accidental merging and is not a reflection of rejection of the submitted code. The associated milestone will be updated when the "On-Hold" tag has been added for clear communication regarding expectations.
Examples of requests of this nature include technology or dependency changes that could introduce major/minor breaking changes.
Once a pull request has been reviewed by two designated approvers it may be merged and the pull request closed.
A special exception has been granted to reduce the number of Designed Approval reviews to 1 for all pull requests related to Build Support when incrementing versions in prepration of a release, or reconfiguration of the environment for the next version.
Additionally a special exception has been granted to merge pull requests created by the Designated Approvers for the purposes of keeping release branches in sync when the pull request ONLY moves previously approved changes. Such as moving bug fixes from a minor release into the next major release, or otherwise.
We follow the process outlined in the Versioning Policy with regards to major, minor, and revision releases. As items are reviewed and approved they will be assigned to a milestone based on their impact and risk. If, when submitting, a specific release is requested coordinate the scope of change with the Designated Approvers or technology advisory group to ensure your item will meet the requirements for the targeted release. We work diligently to accept all pull requests, but ultimately must keep the platform stable and predictable for all users.
The review team will work to respond to all pull requests in a timely fashion. If changes or additional information is requested a pull request will remain open allowing the submitter to update their contribution accordingly. If a request for additional information or changes is not completed with 90 days of request the Pull Request will be closed to keep the pipeline clear. Once the needed information has been gathered the information can be re-submitted via a new Pull Request.
For expedited processing you may reference the prior Pull Request.