Add author association to review summaries and thread comments

[kuychaco]

Please be sure to read the contributor's guide to the GitHub package before submitting any pull requests.

Requirements

• Filling out the template is required. Any pull request that does not include enough information to be reviewed in a timely manner may be closed at the maintainers' discretion.
• Suggestion: You can use checklists to keep track of progress for the sections on metrics, tests, documentation, and user research.

Description of the Change

Our trusty Community and Safety team pointed out that displaying "first time contributor" badges encourages people to be kind to new folks, etc.

This PR introduces authorAssociation information provided by the GitHub GraphQL API to indicate the author's relationship to the repository (member, owner, collaborator, contributor, first-time contributor, first-timer, none). See API docs for more information.

Badges for author association are displayed on review summary comments as well as review thread comments.

See #2056 for reference.

Screenshot/Gif

Summaries:

Review threads:

Alternate Designs

None were considered.

Benefits

Folks have more context about the author of the comments and can therefore adjust their responses accordingly. For example, responses to comments made by "First-time contributors" warrant extra thought and attention, to ensure that we are welcoming new contributors and effectively growing our communities -- https://github.blog/2017-07-25-making-it-easier-to-grow-communities-on-github/

Possible Drawbacks

There is limited space in comment headers. An additional badge adds some visual noise, and if the panel width isn't large enough, the badge appears on a separate line:

Applicable Issues

#2056

Metrics

N/A

Tests

Added unit tests to ensure that text shows up correctly for each author association value (member, owner, collaborator, contributor, first-time contributor, first-timer, none). Did this for both review summary comments and thread comments.

Documentation

N/A

Release Notes

Add author association badges to GitHub review comments.

User Experience Research (Optional)

N/A

TODO: make summary badges drop to new line (as is the case for thread comments)

[codecov]

Codecov Report

Merging #2085 into master will increase coverage by <.01%.
The diff coverage is 100%.

@@            Coverage Diff             @@
##           master    #2085      +/-   ##
==========================================
+ Coverage   92.55%   92.55%   +<.01%     
==========================================
  Files         207      207              
  Lines       12016    12021       +5     
  Branches     1745     1746       +1     
==========================================
+ Hits        11121    11126       +5     
  Misses        895      895

Impacted Files	Coverage Δ
...ainers/accumulators/review-comments-accumulator.js	100% <ø> (ø)	⬆️
...iners/accumulators/review-summaries-accumulator.js	100% <ø> (ø)	⬆️
lib/views/reviews-view.js	83.23% <100%> (+0.51%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f98abf3...4a8615e. Read the comment docs.

[annthurium]

looks good!! Thanks for taking this on.

[annthurium]

Thanks for being thorough and testing all the associations!

I really want you to not have to type all these things out manually. I wish it was possible to do something like...

const {summaries, commentThreads} = aggregatedReviewsBuilder();
let idx = 0;
Object.entries(authorAssociationText).forEach(([key, value]) => {
  addReviewSummary(r => r.id(idx).authorAssociation(value));
  idx ++;
});
summaries.build();
comments.build();

I don't think we can actually use the builders that way though.

I mean, you could create a new review and summary for each association and then test those. Since you already put in the effort to manually type all these out, not sure it's worth the time to optimize.

[vanessayuenn]

Thanks for tackling this!