Play store listing copy

This document is the only copy of the listing text. The Console is where it is pasted, not where it lives — a value that exists only in a web form cannot be reviewed, translated as a set, or recovered when someone edits it by accident.

Three scripts read this file, so its headings are load-bearing:

The gate exists because of a real failure. A release shipped to production carrying the previous version’s release notes: versionName had been bumped and the notes had not, nothing compared the two, and Play does not allow release notes to be edited on a live release. The correction had to wait for the next upload. Renaming a heading is cheaper.

Fields shared across both locales

English (default listing language)

Play counts characters, not words, and rejects at the limit rather than truncating. Keep the count in the heading and update it when you edit: it is the only warning you get before the Console refuses a paste.

App name — 0/30

The app name is not translated, in any locale. app_name is translatable="false" for the same reason, so every listing carries the same name.

Take your meds

Short description — 0/80

The line that appears under the name in search results, and the most-read text in the listing.

Full description — 0/4000

No health or safety claims, here or on any page the listing links to — Play’s enforcement reads a linked page as part of the listing. Say what the app cannot do instead.

The shape the apps built from this template converged on, with headings in capitals because Play renders no markup. The block below is what play-metadata.py uploads, so the outline stays out of it:

1. One or two sentences: the problem, and what the app does about it.
2. HOW IT WORKS — what happens, in the order the user meets it.
3. FREE, AND NOTHING LEAVES YOUR PHONE — no ads, no account, no server; “it does not request the internet permission” only while aab-permissions.py forbids INTERNET; what it stores.
4. WHAT IT CANNOT DO — the honest limits, and what a phone or the platform can stop.
5. PERMISSIONS — one line each, in the user’s words.
6. A last line pointing at the source: github.com/maks-sredniawa/take-your-meds.

Polish

App name — 0/30

Take your meds

Short description — 0/80

Full description — 0/4000

Release notes (Play’s “What’s new”, 500 chars per locale)

Don’t paste these by hand. The Console takes all languages in one textarea, tagged by locale, and scripts/play-whatsnew.py renders exactly that from the blocks below:

python3 scripts/play-whatsnew.py                 # newest version here, to stdout
python3 scripts/play-whatsnew.py --version 0.1.0 # a named one

It reformats and never retypes, so this document stays the only copy. It exits non-zero if a note is over 500 characters, or if a language the app ships has no note at all — both of which Play accepts in silence and a user then reads.

The label above each block is parsed, not decorative: **<Language>** — <n>/500: on a line of its own, with the fenced note under it. The count is what keeps a note from reaching Play truncated, and play-whatsnew.py refuses a language the app ships and this section does not.

Write these about what changed for the person reading them. A schema migration is not a release note; the feature it made possible is. A release where nothing user-visible changed still needs a heading — rename it and say so in one line, so the decision is deliberate rather than made by default.

0.2.0 — the first build (0.1.0 was never released)

English — 18/500:

The first release.

Polish — 18/500:

Pierwsze wydanie.

0.3.0

English — 440/500:

Reminders: give a medicine its times of day, and a notification arrives at each one with a Taken button. New Today tab: today's doses, Due or Taken, each one marked as taken with a tap, and Undo if it was a mistake. The first time you set a time, the app asks to show notifications and to set exact alarms. Help and feedback gains a support address to copy, and an About section with the app's web page, privacy policy, credits and version.

Polish — 475/500:

Przypomnienia: ustaw godziny przyjmowania leku, a o każdej z nich przyjdzie powiadomienie z przyciskiem Przyjęto. Nowa zakładka Dziś: dzisiejsze dawki, do przyjęcia lub przyjęte; każdą można jednym dotknięciem oznaczyć jako przyjętą, a pomyłkę cofnąć. Przy pierwszej ustawionej godzinie aplikacja prosi o zgodę na powiadomienia i dokładne alarmy. W Pomocy i opiniach jest adres do skopiowania oraz sekcja O aplikacji ze stroną, polityką prywatności, podziękowaniami i wersją.

0.4.0

English — 363/500:

Snooze: a reminder can now be put off for 10 minutes, and it comes back even if the phone restarts in between. Today shows until when a dose is snoozed. A delayed alarm no longer brings back a reminder you swiped away, and deleting a medicine no longer leaves its reminder behind. When every time you set starts tomorrow, Today now says the next dose is tomorrow.

Polish — 383/500:

Drzemka: przypomnienie można teraz odłożyć o 10 minut i wróci, nawet jeśli telefon w międzyczasie uruchomi się ponownie. Na karcie Dziś widać, do której trwa drzemka dawki. Opóźniony alarm nie przywraca już odrzuconego przypomnienia, a usunięcie leku nie zostawia jego przypomnienia. Gdy wszystkie ustawione godziny zaczynają się jutro, karta Dziś mówi, że następna dawka jest jutro.