Voting and Voting Workflow (Enforcing) for Pull Requests
Voting for Pull Requests enables the administrator to merge any repository only if a Pull Requests gets that many positive votes in total. Any user who can read the repository or Pull Request then he can also send a vote. Except the original submitter of the Pull Request, he cannot vote. Users can Vote with +1 or -1, and same time can also add a wiki comment why they do this. The Pull Request can be rejected or revoked regardless of the Voting. After the total number of Votes (including positives and negatives) is reaching the Vote threshold only then the integrators can merge it. Even integrators cannot merge if the Vote limit is not reached.
Let's look at this process in screenshots:
Configuring Voting and Voting threshold Voting can be enforced by setting the threshold on the properties page of the protected repository. The Voting number can be any number greater than 0, and 0 will effectively disable this.
Submitting a Vote : When viewing an Pull Request the Voting widget appears in the action-bar as visible here. You can send your Vote by clicking on either the up/green hand for "Yes" or the down/red hand for "No". The current total number of the Votes is shown between the two hand icons.
When mouse moves over this widget the tooltip will show these informations:
• The number of Votes required in total.
• The number of Yes and No votes.
• Your own vote if that was submitted already.
Vote comment_
When a Vote hand is clicked you can also add your comment:
Vote submitted : After your -or others'- Votes are submitted the Vote statistics will appear. Also if the threshold is reached the Merge link is available. For any Votes that is also appearing as a comment on the Pull Request:
The integrators can see how voting goes when looking at the Pull Requests' list:
