Skip to content

Quality Guidelines: be a bit more lenient with complex screenshots #449

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Quality Guidelines: be a bit more lenient with complex screenshots #449

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8b4c8f6
Quality Guidelines: be a bit more lenient with complex screenshots
cassidyjames Mar 5, 2025
04662b8
Quality Guidelines: more window size details
cassidyjames Mar 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions docs/02-for-app-authors/03-metainfo-guidelines/01-quality-guidelines.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -382,11 +382,18 @@ remove the shadow and rounding.
### Reasonable window size

In order to ensure that text and interface elements are visible scaled
down in the app store UI the window size should be 1000x700 pixels or
smaller (2000x1400 for HiDPI).
down in the app store UI, the window size should typically be around
Comment on lines 384 to +385
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you didn't touch this but "are visible scaled down" seems like wrong grammar. What is this trying to say?

"are visibly scaled down" or "are visible and scaled down"?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think "are visible when scaled down"?

1000x700 pixels or smaller (2000x1400 for HiDPI).

![Examples for screenshots that are too large, and the correct size.](assets/screenshot-size.png)

For complex apps that are often used maximized and with many UI panels
(e.g. 3D modeling or game engines), larger screenshots may be used so
long as they are visually helpful, the specific UI text is less
important, and the screenshot is demonstrative of typical use of the
app. However, extra care should be taken to avoid large, empty areas
of the window.

### Image captions

Every screenshot should have a [caption](https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-screenshots)
Expand Down