Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. The editor commits some update
    1. A reasonable message is included in the commit, explaining what was updated.
      1. Given there is only a few characters allowed in the first line of commit, the second line of text should probably be used. 
    2. Generally, a separate commit should be performed for each submodel.   An exception to this would be if the multiple models relate as part of some effort (some cross-model contribution).
    3. IISOMI modeling guidelines must be followed, and reviews must assure that the guidelines are being adhered to before discussion occurs in some working team.
    4. The committer should assign reviewers
      1. One primary independent reviewer and perhaps a backup reviewer to perform the +1.  This individual cannot be the model owner or the editor performing the papyrus commit.
      2. The model owner is responsible for performing the +2 after the independent +1 is completed.
      3. Suggested +1 and +2 Committers by submodel (Kevin to reconcile with owner list in Papyrus
        1. Common:  Xu + 1 ; Kevin +2  
        2. Kevin work on this
    5. The committer can must also supply a gendoc output of the submodel (or the relevant portion of the submodel), supplying it to the committers the reviewers to facilitate easier approval.  Settle on where this will be 
  2. Reviewers
    1. The committer cannot review, approve, or merge their own contribution.
    2. Reviewers should not work for the same company as the committer (at least not the reviewer performing the +1)
    3. Reviewers should be familiar with the subject area of the contribution if possible.   This suggests they participate on the weekly calls related to the contribution.   It is noted that there may be exceptions to this (work on party, business interaction, etc. may be "new" to all.
  3. Approvals
    1. Generally, commits to gerrit are a "work in progress" given commits are encouraged on a weekly basis.   We want to turn these around quickly to facilitate further development (commit on Friday, approved and merged for recloning and further work the following Monday).
    2. The first reviewer should only do a +1 (or -1).
      1. In order to perform the review, the reviewer has either downloaded the Papyrus model files, loaded them into Papyrus and reviewed, or reviewed the output of the model (WIKI, gendoc, etc), or in some other way is familiar with the commit.
    3. The second reviewer will then
      1. perform the +2 and merge.   This reviewer will either 'trust' the review of the first reviewer and/or perform a review themselves.
      2. reject the contribution (-1)
      3. Provide a +1 and assign a third reviewer if one is not already assigned.    This is presumably for situations where the committer is not comfortable providing the +2 and merge.
    4. If multiple reviewers are assigned, all are not required to review to do the merge, just the first two.
    5. If an additional reviewer examines the commit at a later time and a major concern is raised, the commit can be abandoned.
    6. For contributions of new material not yet socialized and/or not fully developed, a fairly 'relaxed' review with perhaps some suggestions is very reasonable. 

...