Files
Viktor Petersson 97651a0de8 docs(website): recommend Raspberry Pi Imager, demote curl|bash to advanced (#3191)
* docs(website): recommend Raspberry Pi Imager, demote curl|bash to advanced

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) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017BbxH9mN3JPpKKF3VmkeCf

* docs(website): mark Raspberry Pi 3 Model A+ as not recommended

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) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017BbxH9mN3JPpKKF3VmkeCf

* docs(website): address review feedback on install docs

- 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) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-16 11:49:52 +01:00
..