Example: Stellar Test Plan

In this segment, we highlight a real-world example of an exceptional test plan that showcases how thoughtful demos not only validate functionality but also build confidence and trust before a single line of code is reviewed.

Key Takeaways:

• We use test plans to demonstrate functionality and edge cases: In this example from the Random Name Picker app, the test plan includes both the core feature (removing images from names) and handling an edge case (screen rotation), showing completeness and attention to detail.
• We treat test plans as trust tokens: A strong demo assures reviewers that the author has thoroughly tested their changes, reducing fear or hesitation around approving the diff.
• We provide a positive starting point for reviewers: Watching the video demo first puts reviewers in the right mindset—making them feel confident that the code works as intended, even before reading the diff.
• We recommend test plans for all product-facing diffs: Especially when there’s a visual or user-facing component, attaching a video or GIF dramatically improves understanding and quality of collaboration.
• We invest a few minutes to add a lot of value: Creating a short demo takes just 5–10 minutes, but it adds context, transparency, and professionalism that elevate the entire code review experience.