Skip to content

Latest commit

 

History

History
61 lines (42 loc) · 5.23 KB

PULL_REQUEST_PROCESS.md

File metadata and controls

61 lines (42 loc) · 5.23 KB
Raw

DNN Platform Pull Request Proceseses

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.

Prerequisites

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.

Code Review Process

Community review of submitted pull requests is encouraged, and all pull requests must be reviewed by at least two (2) community approvers before the change can be approved. Once approved by two unique individuals the change can be merged by the secondary approval. At the current time the following community members are designated approvers.

  • Mitchel Sellers (mitchelsellers) - Community Technology Advisory Group Lead
  • Oliver Hine (ohine)
  • Brian Dukes (bdukes)
  • Peter Donker (donker) - Community Developer Advisory Group Lead
  • Vicenç Masanas (vmasanas)
  • Erik van Ballegoij (erikvb)

Additionally, the following individuals from ESW/DNN Corp are approved reviewers.

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.

Approval & Merging Process

Once a pull request has been reviewed by two individuals it may be merged and the pull request closed.

This MUST NOT be done by the submitter of the Pull Request for ANY reason!

Stale Pull Requests

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.

Items for Future Releases

If an item was submitted that will be integrated into a future release that is not currently in the development pipeline it is possible that the Pull Request will remain open.

In this situation the reviewing team will approve the request, tag the request with a specific version milestone and add a comment noting when and why it will be included in the particularly identified release.

This most often will apply to technology or dependency changes that require alignment with Major, Minor, Revision build inclusion.