Group programming

Permissions

You need the Configurations permission to turn on group programming.

back to top

Enabling group programming

To find group programming:

1. Click Settings in the top navigation.
2. In the left navigation, click Configurations located under Report settings.
3. Click the Group programming tab on the Configurations page.

To enable group programming:

1. Navigate to the Group programming tab on the Configurations page.
2. Toggle the Enable toggle On.

Enter the label you want Flow to apply to group programming commits from into the text box under labeling.

back to top

Assigning work to others

Use the toggles in the Assigning work to others section to set how Flow identifies when a commit is co-authored.

Toggle on Using Co-Authored-By in the commit message so your git host can mark commits with multiple authors:

• This convention is used by git hosts to mark commits with more than one author. For an example, learn more about creating a commit with multiple authors (external site, opens in new tab) in GitHub.
• For group commits authored solely on the commit message, you must include Co-authored-By with an email address or a GitLab username with an email address.

Toggle on Using multiple names in the user.name and user.email fields so you can manually mark commits with multiple authors:

• This toggle is useful for commits with user.name and user.email fields similar to:
  • Jen Smith & Robert Aspens jsmith@mycompany.com, raspens@mycompany.com
  • Jen Smith & Robert Aspens raspens@mycompany.com

When the Using multiple names in the user.name and user.email fields is toggled On, the Prefixes, E-mail delimiters, and Name delimiters text boxes are active and editable.

Enter any prefixes or delimiters you want Flow to check for. Flow labels any commit containing these values in user.name or user.email as group work.

1. Click the Add another button to enter additional values. 
2. Click the X button to remove a value.

For example, a commit’s user.name field contains Jen Smith & Robert Aspens. The commits user.email field contains jsmith@mycompany.com,raspens@mycompany.com.

In this example, Flow labels the commit as group work when a text box under Email delimiters contains , or a text box under Name delimiters contains &.

Learn more about Manually marking a commit as a group commit.

Allocating credit for group work

Configure how Flow assigns credit for group work. You can split the work between contributors or give each contributor full credit.

Choose whether credit is split evenly or each contributor gets full credit for these metrics:

• Coding days
• Commits per day
• Impact
• HALOC metrics, including Rework, Efficiency, New work, and Legacy refactor.

Click Save Changes once you’re done adjusting your group programming settings.

back to top

Viewing group programmed commits in reports

Once you’ve enabled group programming, Flow shows co-authored commits as squares in Work log.

To view group commits in Work log:

1. Click Reports to navigate to Flow’s Reports home page.
2. Click Work log in the left navigation under Daily check.
3. Check the Group box in the custom filter on the left.

Click a group commit to see more details.

If Flow missed a commit or added too many authors, update the commits manually.

Learn more about manually marking a group commit.

back to top

If you need help, please contact Pluralsight Support.