The fifth get-started screenshot — a client's host list — and the workflow change that made it reachable #352

Merged

enricobuehler merged 2 commits from docs-host-list-shot into main 2026-08-20 06:19:39 +00:00

Conversation 0 Commits 2 Files Changed 3

+22 -1

enricobuehler commented 2026-08-19 23:26:05 +00:00

Owner

Copy Link

Copy Source

Closes the remaining half of phase-2 item 2.

The blocker first: linux-client-screenshots uploads its PNGs as an actions/upload-artifact v3 artifact, which Gitea's API doesn't serve — browser-only, so the shots couldn't be reused for docs from a session. The workflow now also publishes every PNG to the generic package registry (punktfunk-linux-client-screenshots/ci/<scene>.png, delete-then-PUT so each run overwrites, REGISTRY_TOKEN like decky.yml, anonymous GET on the public repo). Verified: dispatch run 19593 on this branch, green, packages fetchable.

Then the shot: hosts.png from that run — saved hosts with pairing state (Online·Paired / Offline·Trusted) plus an unpaired host found on the network (PIN) — cropped to the cards and placed in quickstart.md step 4, right at "your host is already in the list". That completes the handoff's screenshot list: console login, Waiting-for-approval + PIN, the Approve dialog, live status (#346), and now a client's host list.

Gates green locally: docs-drift, docs-links, docs-site build + lint.

Closes the remaining half of phase-2 item 2. **The blocker first:** `linux-client-screenshots` uploads its PNGs as an actions/upload-artifact **v3** artifact, which Gitea's API doesn't serve — browser-only, so the shots couldn't be reused for docs from a session. The workflow now also publishes every PNG to the generic package registry (`punktfunk-linux-client-screenshots/ci/<scene>.png`, delete-then-PUT so each run overwrites, `REGISTRY_TOKEN` like decky.yml, anonymous GET on the public repo). Verified: dispatch run **19593** on this branch, green, packages fetchable. **Then the shot:** `hosts.png` from that run — saved hosts with pairing state (Online·Paired / Offline·Trusted) plus an unpaired host found on the network (PIN) — cropped to the cards and placed in `quickstart.md` step 4, right at "your host is already in the list". That completes the handoff's screenshot list: console login, Waiting-for-approval + PIN, the Approve dialog, live status (#346), and now a client's host list. Gates green locally: docs-drift, docs-links, docs-site build + lint.

enricobuehler added 2 commits 2026-08-19 23:26:09 +00:00

linux-client-screenshots: publish the PNGs to the generic package registry too — the v3 artifact is browser-only, which blocked reusing the shots for the docs ... 674b16d8eb

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs(quickstart): the client host list — the fifth get-started screenshot, pulled from the pipeline the previous commit teaches to publish ... a8099e0f5b

Saved hosts with their pairing state + an unpaired host found on the network, from
linux-client-screenshots run 19593 via the new generic-package publish (fixed 'ci' version,
anonymous GET), cropped to the cards. Completes the handoff's screenshot list: console login,
Waiting for approval + PIN, the Approve dialog, live status, and a client's host list.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

enricobuehler merged commit 21d9190324 into main 2026-08-20 06:19:39 +00:00

enricobuehler deleted branch docs-host-list-shot 2026-08-20 06:19:50 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

FernandoMX FlipperDan HitFrostbite bluelightspecial enricobuehler (Enrico Bühler) kszlim luxus nannku neoney

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: unom/punktfunk#352