adom-desktop page: let a page caption the Install and Download cards (what each is for)

Overview Files Skills Discover Packages Releases Dependencies Issues4 Breadcrumbs Pull Requests Activity

Closed general

John Lauer · 14d ago ·closed by Colby Knox

Reported by the Adom Desktop team (John).

adom-desktop is an unusually complex page, because it hosts two different install artifacts for two different audiences, and a visitor cannot tell them apart from the compact cards:

The Download card (the signed .exe) is the Windows desktop app. A human installs it on the PC they want a cloud AI to reach.
The Install card (adom-wiki pkg install adom/adom-desktop) is the Linux CLI plus the Claude skills. It installs inside a cloud container, and it is what drives the desktop above.

(There is also a third artifact, version.json, the auto-update manifest, which is not user facing at all.)

Today neither card carries a one-line explanation of what it is for. The real explanation lives further down in the README body ("Downloads" table), which a visitor scanning the two cards at the top never reads. So a new user sees a Windows .exe and a pkg install command sitting side by side with no signal that one is "for your PC" and the other is "for a container." That is the single most confusing thing on the page.

Request: let a page declare a short caption that renders directly under each card. For example:

Render the release title or changelog under the Download card. (I set both on the 1.9.95 release, but they do not currently render on the card, so today there is no way to caption the exe at all.)
Render the pkg description, or a new install_caption field, under the Install card.

A single line under each card ("For your Windows PC" versus "For a Linux cloud container") would remove the most common point of confusion on this page. The attached screenshot shows the full page: rich content, but the two cards themselves are unlabeled.

screenshot-1783427913038

1 Reply

Colby Knox · 13d ago

Shipped and live on the adom-desktop page. The Install + Download cards are now grouped in a bordered "Get it" block (so Contents below starts a clear new region -- #92), each card carries an author caption (#91/#93), a "?" appears next to the Download heading when the pkg and release versions differ (#91), and the download card has a native details-on-hover tooltip with the full filename + exact bytes + sha256 + platform/arch + upload time (#94).

Author controls: the Install caption comes from the manifest install_caption (falling back to the pkg description); the Download caption comes from the release title -- set it with adom-wiki release edit <ref> <version> --title "For your Windows PC — the signed desktop app" and it renders on the card (previously it did not).

Deferred: the "managed by " badge on the download card (needs reverse-dep knowledge of which app auto-manages the runtime) -- say the word if you want it as a follow-up. Closing.