Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: added cross link to the committer template

...

Committer Promotion Prerequisites

ONAP membes contributors seeking promotion to committer status should demonstrate the following abilities and behaviours behaviors before being considered for promotion.  Ideally the individual has been participating in the community and several projects including the one they are seeking promotion to.  Contributors can perform 95% of the duties of a formal committer including the following which would be expected from both contributors and committers.

  • Gerrit involvment - putting up reviews of their own, reviewing other reviews of contributors/committers - you can add yourself as a reviewer as well.
  • Ability to build, deploy and run your own project in the context of a larger ONAP deploy
  • Ability to build and debug your own project in an IDE like Eclipse or IntelliJ
  • Proactive - do not wait to be part of a epic/story/task or wait to be part of a review, or wait to bring forward build/design issues, or wait to bring new capabilities to the project and any other members of ONAP pushing or pulling from your component
  • JIRA involvement - including one or more of raising, reviewing, commenting, testing, linking, attaching to, answering questions on, closing JIRAs
  • Design review of all the release Epics and wiki documentation for the current and pending release.
  • Confluence involvement - writing/editing/reviewing/answering-on wiki pages around their projects, building in general
  • Git involvement - being able to clone, build, patch, commit and run the code in their project and ideally any of the north or southbound dependend projects
  • Knowledge of the architecture and API of the project - ideally across ONAP
  • Participation in onap-discuss work including helping with issues, raising issues
  • Participation in the weekly project meeting
  • Participation in pre-release blitzes
  • Participation as secondary PTL in the TSC when required
  • Integration ability - the developer should be able to bring up the entire ONAP deployment either in OOM or HEAT to be able to E2E test their particular component and any flows involving it

To start the promotion process, please use the Committer Request Template

Best Practices

  • Committers should not "self merge" their own changes
    refer to

    https://lists.onap.org/pipermail/onap-discuss/2018-February/008068.html

    https://lists.onap.org/pipermail/onap-discuss/2018-February/008181.html

    https://lists.onap.org/pipermail/onap-tsc/2017-May/002341.html

    TSC 2018-03-08


    • Committers should add other committers as reviewers and have at least 2 Committers show approval (with a +1). The first reviewing committer will +1, the second reviewing committer will +2.
    • One exception to the rule is self merging critical changes required to unblock broken builds - maybe.
  • Committers should only merge proposed changes from contributors after at least 2 (+1) reviews.
  • Committers should remove themselves from a review under the following circumstances: 
    • Committer has been added as a reviewer to a change they do not feel comfortable reviewing
    • Committer anticipates a lack of time to review within 1 week 
  • Committers who remove themselves should leave a short comment in the change explaining to the owner the reason for removal
    • This allows owners opportunity to find others willing to review (or to make changes to significantly simplify or further document change)
  • Committers should aim to review all pending changes which have passed verify, have no merge conflicts or (-1) or (-2) reviews in a timely manner. 
  • Committers are welcome to ignore pending changes which do not pass verify, have merge conflicts or have been reviewed (-1) or (-2).
  • Committers should occasionally review the list of all old changes (To be defined). Owners of old changes should be contacted to ascertain if the change can be abandoned. If change owners do not respond or respond that the change has been abandoned, it should be abandoned.

...