diff --git a/docs/PLAY_RELEASE_CHECKLIST.md b/docs/PLAY_RELEASE_CHECKLIST.md index bae441d..07ce804 100644 --- a/docs/PLAY_RELEASE_CHECKLIST.md +++ b/docs/PLAY_RELEASE_CHECKLIST.md @@ -94,7 +94,10 @@ action except the items marked **[code]**. ⚠️ Play rejects a screenshot whose longer side is more than 2× its shorter side, so a 1080×2400 phone capture has to be cropped to 1080×2160; `tools/make-store-screenshots.sh` does exactly that (status and navigation bars only). -- [ ] Category: *Tools* (or *Photography*). Tags: photo cleanup, duplicates. +- [ ] Category: *Tools* (or *Photography* — pick it **before** the tags, because it shapes the + *Suggested tags* list). Tags: **max 5, chosen from Play's own list, not typed freely** — the + recommended set and the ones to avoid are in + [STORE_LISTING](STORE_LISTING.md) › Category and tags. ## 5. Policy and compliance diff --git a/docs/STORE_LISTING.md b/docs/STORE_LISTING.md index b23c4dd..73cbb9d 100644 --- a/docs/STORE_LISTING.md +++ b/docs/STORE_LISTING.md @@ -216,7 +216,35 @@ in `app/build.gradle.kts`, and the second-run speed-up is the persistent hash in ### Category and tags - **Category:** Tools (alternative: Photography — *Tools* matches the one-job utility framing - better, and Photography is more crowded). -- **Tags:** duplicate photos, photo cleanup, storage. + better, and Photography is more crowded). Choose the category **first**: the *Suggested tags* + list is influenced by it. +- **Tags:** Play allows a **maximum of five**, and they can only be chosen from Play's own list + (*Suggested tags*, then *Search tags* / the category filter / *Other tags*) — there is no free + text. Apply them under **Store settings › App category › Manage tags**, in this order: + + | # | Tag | Why it is unambiguously true of this app | + |---|---|---| + | 1 | **Duplicate photos** | The literal function, and the phrase a user types into search. | + | 2 | **Photo cleanup** | How the short and full description frame the job ("find and remove"). | + | 3 | **Photo management** | Google's own one-line description of the *Photography* category is "Cameras, photo editing tools, **photo management**, and sharing" — so this tag matches their taxonomy wording. | + | 4 | **Storage** | The benefit the listing leads with: `03-results.png` shows 17 groups and 83.5 MB reclaimable. | + | 5 | **Photo gallery** | The thing being managed; swap it if *Suggested tags* offers something closer. | + + If a *Suggested tag* is a better match than #4 or #5, take the suggestion — the full taxonomy + is only visible inside the Console, so those two are the interchangeable ones. Google's + guidance is to leave the tags alone afterwards and re-evaluate only if the app's functionality + changes significantly; edits take up to 24 h to appear. + +- **Tags deliberately not used** — each would be either off-target or actively misleading: + *Photo editing*, *Camera*, *Video*, *Backup*. + The app cannot edit, cannot take photos and does not scan videos + ([README › Known limitations](../README.md#known-limitations)), and a *Backup* tag would + contradict the "no uploads, no internet permission" promise the description is built on. + Google's test is whether an unfamiliar user can see why the tag is relevant from the listing — + for these, they cannot. +- **Accessibility tags: none (yet).** They are a compatibility *claim* and the UI does not earn + one: `ui/components/PhotoThumbnail.kt` holds the only `contentDescription` in the app, and the + scan-progress text has no `liveRegion`, so progress is not announced automatically. TalkBack + support is a follow-up, not a listing decision. - **Contact details:** `softwareapp.hb@gmail.com` — the same address as in [PRIVACY.md](../PRIVACY.md), so the policy can be hosted as-is.