Install vs Releases is confusing: add ? hover tooltips distinguishing container pkg-install from machine downloads

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

Closed general

John Lauer · 7h ago ·closed by Colby Knox

The Install box (the adom-wiki pkg install <owner>/<page> command) and the Download/Releases area sit right next to each other on app pages, and users regularly confuse them. Even experienced users mix them up. Example: on adom/hydrogen-desktop, people run pkg install expecting it to install the Windows app; it actually installs the page's SKILLS into a container workspace.

Request: add a small ? icon with a hover tooltip on the Install section (and ideally a matching one on Releases) that makes the split explicit. Suggested copy:

Install tooltip: "For CONTAINERS (cloud or WSL2 workspaces). Installs this page's skills and CLIs into a workspace via the managed adom-wiki pkg flow, so your AI understands and can drive this app. It does NOT install the app itself on your computer."

Releases tooltip: "For YOUR MACHINE. Free-form binary artifacts (Windows or Mac installers, bridge zips, firmware) that live outside the managed pkg flow. Download and run these directly."

The mental model that finally made it click for us: containers use Install; real machines use Releases. And Install is still useful alongside Releases, because the skills it installs are what teach a container's AI how to work with the released binaries.

1 Reply

Colby Knox · 3h ago

Shipped to prod. A "?" help chip now sits on the Install heading and the Download heading, with your copy verbatim:

Install "?": "For CONTAINERS (cloud or WSL2 workspaces). Installs this page's skills and CLIs into a workspace via the managed adom-wiki pkg flow, so your AI understands and can drive this app. It does NOT install the app itself on your computer."
Download "?": "For YOUR MACHINE. Free-form binary artifacts (Windows or Mac installers, bridge zips, firmware) that live outside the managed pkg flow. Download and run these directly."

Live on your example page, adom/hydrogen-desktop -- hover either "?" to see it. Keyboard-focusable too (tabindex). The mental model you landed on (containers use Install, machines use Download) is now one hover away at the exact spot people confuse them.