Review Map Tours Quick Start
Types of code review walkthroughs to make for your team in 1 min or less
Code Reviews are a lot for anyone to manage let alone if you are reviewing 20 files or more. Review Map Tours let the author guide the reviewer around giving them key information to save 30% of the reviewers time.
Here are 3 types of Tours you can create.
1. TL;DR - Start here
Code hosts like Github display the files changed alphabetically. So providing a tour point on a Review Map indicating to the reviewer "Start Here" will shave off the time it take for the reviewer to get oriented.
2. Walk through
A good tour can be as comprehensive as the PR author needs it to be in order to guide the reviewer. Good PR Tours at a minimum should articulate:
- What changes you made
- In what order to review the changes
- Why you made the changes you did
Gotchas
Sometimes there's a particularly tricky part of a code change. The reason we made that code change might not be 100% obvious. Creating a tour point to explain a gotcha is a quick way to help someone wrap their head around the review and get your change merged. No meeting required!
Updated 2 months ago