Landscape Picture

This is a rough DRAFT to be expanded and reviewed.

Problem

When you take a screenshot to explain an issue, how much should you zoom into the picture?

Forces

In a large screenshot it may be hard to see the actual issue. Zooming in may highlight an issue, but loses important context. In general, you can't know what other people will find interesting or important.

Solution

Always design your screenshot to show the full window to not lose any context.

Steps

Although there is a great temptation to crop a screenshot just to show a problem, this can tell a very misleading story by leaving out important details. As a consequence, always take a full screenshot of the entire window, showing all the parts, such as the code snippets that got you where the issue is. (Need to select a few nice examples from Slack or Discord.)

Related patterns

...