Site: how-tos and the FAQ (phase 3) #65

2026-10-06T19:00:36Z

twisla commented

2026-10-06 19:00:36 +00:00

Phase 3 of the site (docs/milestones/W1.md, Q179): how-tos and the FAQ. Touches only site/ and docs/.

/howto/: eight recipes (when flashing fails, find your files on the SD card, update from the card, a network without DHCP, record a Track, capture LoRa packets for Wireshark, Gemini offline, "not enough memory"), each a handful of numbered steps.
/faq/: 16 questions with a list at the top: mesh messaging (not yet), what it needs, regions, privacy (says that the device checks the project's server once a day), own builds, memory, the SD card.
The guide templates are generic now: the parent section provides the eyebrow, title and pager. Linked from the guide's index; the navigation is unchanged.
Everything comes from the README, the milestone documents and the Apps' source. No kind/docs issue held a user question (they are mesh design rounds).

Checked: Zola build, check_site.py 26 pages / 0 problems (now including every internal link), FAQ and a how-to looked at in a browser.

Not checked: the steps on a real device, one by one. Two statements describe your own setup rather than the code: the FAQ's "server logs keep only a masked part of visitors' addresses" (the Caddy log masking you added) and the security.txt mention.

Conflicts: none expected with #64 (the devlog); I kept base.html and the W1 status line untouched, so the W1 status line still says phase 2 until #64 lands.

🤖 Generated with Claude Code

https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT

Phase 3 of the site (docs/milestones/W1.md, Q179): how-tos and the FAQ. Touches only `site/` and `docs/`. - `/howto/`: eight recipes (when flashing fails, find your files on the SD card, update from the card, a network without DHCP, record a Track, capture LoRa packets for Wireshark, Gemini offline, "not enough memory"), each a handful of numbered steps. - `/faq/`: 16 questions with a list at the top: mesh messaging (not yet), what it needs, regions, privacy (says that the device checks the project's server once a day), own builds, memory, the SD card. - The guide templates are generic now: the parent section provides the eyebrow, title and pager. Linked from the guide's index; the navigation is unchanged. - Everything comes from the README, the milestone documents and the Apps' source. No `kind/docs` issue held a user question (they are mesh design rounds). Checked: Zola build, `check_site.py` 26 pages / 0 problems (now including every internal link), FAQ and a how-to looked at in a browser. Not checked: the steps on a real device, one by one. Two statements describe your own setup rather than the code: the FAQ's "server logs keep only a masked part of visitors' addresses" (the Caddy log masking you added) and the security.txt mention. Conflicts: none expected with #64 (the devlog); I kept `base.html` and the W1 status line untouched, so the W1 status line still says phase 2 until #64 lands. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT

twisla added 1 commit 2026-10-06 19:00:37 +00:00

Site: how-tos and the FAQ (phase 3)

Site / build (pull_request) Successful in 8s

Details

ba10ff4a5d

Eight how-to recipes and a FAQ page with a list of its questions, from the
README, the milestone documents and the Apps' source. The guide templates
become generic (the parent section gives the eyebrow, title and pager).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT

twisla added 1 commit 2026-10-06 19:08:33 +00:00

Merge branch 'main' into site-howto

Site / build (pull_request) Successful in 9s

Details

3c653e6a8f

twisla merged commit 8f95bee744 into main

2026-10-06 19:08:43 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: twisla/roro9stack#65