feat: Document review request events in Timeline struct

[jbrill]

Add review request event documentation to Timeline struct

Updates the Timeline struct documentation to include review request-related events that were missing from the Event field description, matching the GitHub API behavior.

Changes

• Added documentation for review_requested event
  • Occurs when an actor requests a review from a user/team
  • Notes that Requester or RequestedTeam will be populated
  • Reviewer will be populated
• Added documentation for review_request_removed event
  • Occurs when an actor removes a review request
  • Reviewer will be populated
  • Notes that Requester or RequestedTeam will be populated

These events were already supported in the implementation via the corresponding struct fields, but were missing from the Event field's documentation.

Local Testing

• Ran the test suite locally to ensure all changes are functioning as expected.
• Verified that the documentation updates do not affect existing functionality.

Tests Written

• Test: TestTimeline_ReviewRequests
  • Validates the handling of review_requested and review_request_removed events.
  • Ensures that the Requester and Reviewer fields are correctly populated.
  • Confirms that the Timeline struct accurately reflects the GitHub API's behavior for these events.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.21%. Comparing base (2b8c7fa) to head (d5b9f7e).
Report is 201 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #3391      +/-   ##
==========================================
- Coverage   97.72%   92.21%   -5.51%     
==========================================
  Files         153      173      +20     
  Lines       13390    14770    +1380     
==========================================
+ Hits        13085    13620     +535     
- Misses        215     1060     +845     
  Partials       90       90              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[jbrill]

I've run all the scripts in step 4 of CONTRIBUTING.md. I believe this is ready for review 👍

[gmlewis]

Thank you, @jbrill !

[gmlewis]

Honestly, there is really no need for this helper function, as there is no need to test the functionality of time.Parse in this repo since it is well-tested with each release of the Go compiler.

The vast majority of our tests use &Timestamp{referenceTime} although I do see some unfortunate deviations from this.

Let's please remove this helper function and use the existing referenceTime instead.

[jbrill]

Sounds good. I've pushed up those changes to use &Timestamp{referenceTime}!

[gmlewis]

Oh, and as described in CONTRIBUTING.md, please do not use force-push in this repo as we always squash-and-merge to create a clean commit history.

[jbrill]

Oh, and as described in CONTRIBUTING.md, please do not use force-push in this repo as we always squash-and-merge to create a clean commit history.

Apologies -- pushed up a new commit with the test changes.

[gmlewis]

Thank you, @jbrill !
LGTM.
Merging.