mirror of
https://github.com/vitorpamplona/amethyst.git
synced 2026-10-05 19:28:25 +00:00
docs: point the Health Connect walkthrough at the drawer entry
The reviewer walkthrough still routed through Workouts and a chart icon in its
top bar. That icon is gone — the Mine/Following split moved to the top-nav
filter — so following the walkthrough would have dead-ended, which is how the
first rejection ("insufficient information to determine app functionality")
started.
The route is now the drawer, where My Fitness is the second entry under "You",
the first section, directly below Profile. That is a shorter path than the old
one and needs no scrolling.
Two other things the walkthrough got wrong, now that the dashboard reads both
sources: an empty Health Connect database no longer means an empty screen, and
a reviewer can populate the dashboard with no health permission at all by
logging a workout in the app. Both are said explicitly, because a reviewer who
sees an empty screen and assumes the feature is broken is the failure mode
these notes exist to prevent.
The sharing step also said to tap Share on any row, which stopped being true
one commit ago: the button is gated on alreadyPublished, so a workout already
posted does not offer it. Said as written, a reviewer would look for a control
that isn't there on some rows.
PRIVACY.md and the store listing carried the same stale path and are fixed to
match.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019egdJyBHnrATZHjs86up8f
This commit is contained in:
+1
-1
@@ -32,7 +32,7 @@ Configuration, cached events, keys, drafts, and other operational data live in t
|
|||||||
|
|
||||||
### Health and fitness data (Health Connect)
|
### Health and fitness data (Health Connect)
|
||||||
|
|
||||||
Amethyst's **My Fitness** screen (Workouts → the chart icon) summarises your own training for you: how much you did this week against last week, how your time splits across activities, your best efforts, how many days you trained, and your current streak. It builds that picture from the workouts your watch or fitness app has already saved to **Android Health Connect**.
|
Amethyst's **My Fitness** screen (drawer → You → My Fitness) summarises your own training for you: how much you did this week against last week, how your time splits across activities, your best efforts, how many days you trained, and your current streak. It builds that picture from the workouts your watch or fitness app has already saved to **Android Health Connect**.
|
||||||
|
|
||||||
This is what the health permissions are for. The summary is computed on your phone and shown to you; nothing is sent anywhere to produce it, and you never have to post anything to use it.
|
This is what the health permissions are for. The summary is computed on your phone and shown to you; nothing is sent anywhere to produce it, and you never have to post anything to use it.
|
||||||
|
|
||||||
|
|||||||
@@ -17,8 +17,8 @@ permission is not a permitted/valid use case."*
|
|||||||
The app changed, not just the wording. Amethyst now has **My Fitness**, a personal training
|
The app changed, not just the wording. Amethyst now has **My Fitness**, a personal training
|
||||||
dashboard that summarises the user's own Health Connect workouts for them: weekly totals,
|
dashboard that summarises the user's own Health Connect workouts for them: weekly totals,
|
||||||
week-over-week movement, a per-activity breakdown, best efforts, active days and a training
|
week-over-week movement, a per-activity breakdown, best efforts, active days and a training
|
||||||
streak. It is reached from the Workouts screen and works fully whether or not the user ever
|
streak. It is its own destination in the navigation drawer, under "You", and works fully whether
|
||||||
publishes anything. Publishing a workout is now one optional action on a row of that dashboard.
|
or not the user ever publishes anything. Publishing a workout is now one optional action on a row of that dashboard.
|
||||||
|
|
||||||
**The permissions serve the dashboard.** If the declaration below is ever re-read against the
|
**The permissions serve the dashboard.** If the declaration below is ever re-read against the
|
||||||
app, the test to apply is: every data type listed is rendered back to the user as their own
|
app, the test to apply is: every data type listed is rendered back to the user as their own
|
||||||
@@ -72,22 +72,33 @@ Related code:
|
|||||||
## 2. Reviewer walkthrough
|
## 2. Reviewer walkthrough
|
||||||
|
|
||||||
> 1. Install and open Amethyst, and sign in (a key can be generated in-app).
|
> 1. Install and open Amethyst, and sign in (a key can be generated in-app).
|
||||||
> 2. Open the navigation drawer (hamburger, top-left), and under **Feeds** tap **Workouts**.
|
> 2. Open the navigation drawer (hamburger, top-left). **My Fitness** is the second entry under
|
||||||
> 3. In the top bar, tap the **chart icon** to open **My Fitness**.
|
> **You**, the first section — directly below Profile. Tap it.
|
||||||
> 4. The screen explains what will be read and offers **What Amethyst reads** (the full rationale
|
> 3. The screen explains what will be read and offers **What Amethyst reads** (the full rationale
|
||||||
> screen) and **Connect**. Tap Connect and grant the permissions. (If the account has already
|
> screen) and **Connect**. Tap Connect and grant the permissions. (If the account has already
|
||||||
> logged workouts in Amethyst, the dashboard is already populated from those and the Health
|
> logged workouts in Amethyst, the dashboard is already populated from those and the Health
|
||||||
> Connect offer appears as a banner above it instead — the feature does not gate on the
|
> Connect offer appears as a banner above it instead — the feature does not gate on the
|
||||||
> permission.)
|
> permission.)
|
||||||
> 5. The dashboard appears: "This week" totals with the change against last week; the streak,
|
> 4. The dashboard appears: "This week" totals with the change against last week; the streak,
|
||||||
> active-days and workout-count tiles; the four-week weekly average; the per-activity
|
> active-days and workout-count tiles; the four-week weekly average; the per-activity
|
||||||
> breakdown; best efforts; and the recent-workout list.
|
> breakdown; best efforts; and the recent-workout list.
|
||||||
> 6. Everything above is the tracking feature. To see the optional sharing path, tap **Share this
|
> 5. Everything above is the tracking feature. To see the optional sharing path, tap **Share this
|
||||||
> workout** on any row — it opens a pre-filled composer that the user must confirm.
|
> workout** on a row in Recent workouts — it opens a pre-filled composer that the user must
|
||||||
|
> confirm. The button appears only on workouts that have not been published yet, so a workout
|
||||||
|
> is never offered for sharing twice.
|
||||||
>
|
>
|
||||||
> Note for a fresh test device: the dashboard needs Health Connect to actually hold finished
|
> My Fitness can also be pinned to the bottom bar, under Settings, like any other destination.
|
||||||
> exercise sessions from the last four weeks, written by some fitness app or watch. With an empty
|
>
|
||||||
> Health Connect database it correctly reports that nothing has been recorded.
|
> Notes for testing:
|
||||||
|
>
|
||||||
|
> - The dashboard summarises two sources: workouts read from Health Connect, and workout records
|
||||||
|
> the account has published from Amethyst. On a fresh device with an empty Health Connect
|
||||||
|
> database and an account that has never logged a workout, it correctly reports that nothing has
|
||||||
|
> been recorded — there is no data to summarise, which is not a failure of the feature.
|
||||||
|
> - To see it populated, either grant Health Connect access on a device whose fitness app or watch
|
||||||
|
> has saved sessions in the last four weeks, or log one in the app: drawer → **Feeds** →
|
||||||
|
> **Workouts** → **+**. A workout logged that way appears in the dashboard without any health
|
||||||
|
> permission at all.
|
||||||
|
|
||||||
## 3. Per-permission justification
|
## 3. Per-permission justification
|
||||||
|
|
||||||
|
|||||||
@@ -16,10 +16,11 @@ classifieds, calendars and more.</li>
|
|||||||
<li>Track your training and share a workout — see below.</li>
|
<li>Track your training and share a workout — see below.</li>
|
||||||
</ul>
|
</ul>
|
||||||
<p><b>My Fitness — track your training</b></p>
|
<p><b>My Fitness — track your training</b></p>
|
||||||
<p>Amethyst includes a personal training dashboard. Open the left drawer, tap <i>Workouts</i>, then
|
<p>Amethyst includes a personal training dashboard. Open the left drawer and tap <i>My Fitness</i>,
|
||||||
the chart icon in the top bar. With your permission it reads the workouts your watch or fitness app
|
under <i>You</i>. It summarises the workouts you have logged in Amethyst, and — with your
|
||||||
has already saved to Android Health Connect (Samsung Health, Google Fit, Fitbit, Garmin Connect,
|
permission — the ones your watch or fitness app has already saved to Android Health Connect
|
||||||
Strava and others all write there) and shows you:</p>
|
(Samsung Health, Google Fit, Fitbit, Garmin Connect, Strava and others all write there). It shows
|
||||||
|
you:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li>How much you trained this week, and whether that is up or down on last week.</li>
|
<li>How much you trained this week, and whether that is up or down on last week.</li>
|
||||||
<li>Your four-week weekly average for time, distance, steps and climb.</li>
|
<li>Your four-week weekly average for time, distance, steps and climb.</li>
|
||||||
|
|||||||
Reference in New Issue
Block a user