docs(website): recommend Raspberry Pi Imager, demote curl|bash to advanced - #3191
Merged
Conversation
…anced New users landed on a `bash <(curl ...)` pipe-to-shell as the first thing they saw, which is intimidating. Reframe the install story so the no-command-line Raspberry Pi Imager path is clearly the recommended method and the scripted install is an advanced alternative: - get-started page: make "Flash an SD card with Raspberry Pi Imager" the primary Step 1; move the one-command install into "Advanced & alternative installation methods". - homepage: tag Imager "Recommended" and the one-liner "(advanced)". - installation-options: add a "Recommended for most users" callout to the Imager section, retitle the scripted section "Advanced: scripted install", and add "read the script before running it" guidance (download + review + run, plus a link to install.sh in the repo). Hugo build clean. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]> Claude-Session: https://claude.ai/code/session_017BbxH9mN3JPpKKF3VmkeCf
|
There was a problem hiding this comment.
Pull request overview
This PR updates the Anthias website installation messaging to lead with the Raspberry Pi Imager “no command line” path as the recommended default, while clearly demoting the bash <(curl …) install flow to an advanced alternative.
Changes:
- Homepage: highlights Raspberry Pi Imager as Recommended and labels the one-liner install as (advanced).
- Get Started page: makes Imager the first step and moves the one-command install into an “Advanced & alternative” section.
- Installation options doc: adds “Recommended for most users” guidance for Imager and reframes the scripted install as an advanced method, including “download → review → run” advice.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| website/layouts/index.html | Rewords and re-labels install cards to emphasize Imager as recommended and one-liner as advanced. |
| website/layouts/_default/get-started.html | Reorders the onboarding flow to lead with Imager and moves the one-liner into an advanced/alternative section. |
| website/content/docs/installation-options.md | Adds recommended/advanced callouts and review-before-run guidance for the scripted installer. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
The Pi 3 Model A+ has only 512 MB of RAM — too little to run the Anthias stack comfortably. Add it to the supported-hardware table with a "Not recommended" status and a note pointing low-cost builds at a board with at least 1 GB (Pi 3 Model B/B+ or newer). Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]> Claude-Session: https://claude.ai/code/session_017BbxH9mN3JPpKKF3VmkeCf
- Demote all in-body `#` headings in installation-options.md to `##`. The docs layout renders the front-matter title as the page `<h1>`, so every `#` section was minting a second H1. h1/h2 are styled identically in docs-prose, so this is a semantic fix with no visual change. - Reword the Imager callout to point specifically at the scripted install rather than "the command-line methods further down" — the sections in between (balenaHub, release images) are not command-line methods. - Use `curl -fsSL` in the download-review-run snippet so an HTTP error fails instead of saving an error body as an executable script. - Link "advanced methods below" to the in-page #advanced-methods anchor instead of /docs/install/. - Fix the cross-page anchor in x86-installation.md, which pointed at the pre-rename #installing-on-raspberry-pi-os-lite-or-debian. - Fix the FAQ link to /docs/#tls-ssl; the real id is #tls--ssl. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
New users were greeted by a
bash <(curl ...)pipe-to-shell as the first, most prominent install step — intimidating and easy to distrust. This reframes the install story around the no-command-line Raspberry Pi Imager method as recommended, with the scripted install clearly marked as an advanced alternative.Changes
install.sh).Hugo build passes (18 pages, no errors); all three edited pages render the new copy.
🤖 Generated with Claude Code