docs: pin down the Play tag set and the ones to avoid

2026-10-14 07:41:47 +02:00
parent 89ddf3bb1d
commit c9382364fc
2 changed files with 34 additions and 3 deletions
@@ -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

@@ -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.