I would make appointments to make a quick call to describe strange bugs in UI. They were never quick. I now take a 30-second video, and put one screenshot in the PR with arrows. Most questions disappear.
I have a simple kit that I use on a daily basis. ScreenRec supports short videos and screenshots and provides me with a link immediately after stopping, without a watermark, time limit, and a small pool of free cloud storage after confirming my email. It works on all the machines I touch, and this is important when I switch between macOS on the laptop and Linux in the lab.
Here’s the routine I follow
Reproduce once, then record. First run is mine, second run is the evidence. I enlarge the browser to 130 percent to ensure that the reviewers with smaller screens can read all the information without straining their eyes. I maintain a brief narration: Hover state flickers when filter chip re-renders; monitor console.
Not only the surface, but the path. I also turn the chip on and off and open devtools and highlight the state change in the clip. Then I make one screenshot with two arrows the chip that switched and the list that did not update. I label it “expected vs. actual.”
Keep links tidy. Using ScreenRec I am presented with a personal URL on my clipboard. I put it in the PR with a three line summary and a recommendation: “We can query debounce the fetch or cache responses. Vote?” Such a slight push propels the review rather than welcomes a discussion.
AI help needs context, too. When I operate Cursor or Claude Desktop, I feed them with the same images. I copy the link and append: This 14-second video demonstrates a stale post-filter list. Based on the snippet ResultsList.tsx below, suggest a fix. The answers are more effective since the instruments can be pegged on something tangible.
Security stays front of mind. I blur emails and tokens. In case a clip is accidentally uploaded to a public channel, I delete it in the cloud dashboard and re-post the screenshot alone.
Could I use other tools? Sure. OBS Studio is excellent with lengthy demos. ShareX is ideal with five-second GIFs. However, in the case of ordinary unblockers, those small pieces of evidence that stop meetings, the ScreenRec rhythm of record, stop, paste link prevails.
Test it on your next PR: one brief video, one annotated photo, one direct request. Look forward to quicker reviews and a reduced number of calendar invites.
Top comments (0)