docs(pi): audit and rewrite Pi6X Flow and Just a Pi docs - #54
Draft
dakejahl wants to merge 3 commits into
Draft
Conversation
Port the Jetson-audit treatment to the Pi products: - ARK-OS pages rebuilt for the deb-based reality: system-level services, current service list (go2rtc, pointperfect; hotspot-updater removed), install/update via install_ark_os.sh, CLI tools, Pi-flavored UI screenshots; Just a Pi gains its missing ARK-OS section - Just a Pi getting-started resolves the bundle-state TODO: bundles ship pre-imaged from ark_pi_image with ARK-OS installed; first-boot hotspot fallback documented - Just a Pi flashing guide leads with the ark_pi_image golden image; manual Raspberry Pi Imager flow kept as the fallback - Stale 'Trixie not verified' hints replaced: ARK-OS ships bookworm and trixie debs and the installer picks automatically - Pi6X firmware page: current UI screenshot, flash_firmware.sh on PATH, un-pin the hardcoded v1.15.0 download link - Reorder both products: setup flow first, reference last
dakejahl
marked this pull request as draft
July 31, 2026 23:36
Collaborator
Author
|
Converted to draft per Alex — holding until first-class |
Rebase onto the reorganized docs: instead of adding per-product ARK-OS pages, generalize ark-os/ to cover Jetson and Pi and give each Pi product a Using ARK-OS landing page. The service set is identical across all five carriers; only the hostname, the device user, and the dds-agent serial node differ, so those are now stated inline. Redirects cover the two Pi6X ark-services URLs.
Collaborator
Author
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
1 participant
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.
Summary
Audits the Pi6X Flow and Just a Pi docs against the current ARK-OS, and points both products at the shared ARK-OS section introduced by #61.
Problem
Both products' ARK Services pages described the retired systemd user-service install and the removed hotspot-updater service, with dead config links and a stale firmware-update screenshot. Just a Pi had no ARK-OS docs at all and a literal TODO where the ships-with state should be, and its flashing guide never mentioned the ark_pi_image golden image that bundles actually ship with. Both flashing guides steered users to Bookworm with a "Trixie not yet verified" warning that predates the trixie deb.
This PR originally added per-product ARK-OS pages to both Pi products. #61 has since consolidated the three Jetson copies into a shared
ark-os/section, so that would have taken the duplication from four copies to six.Solution
ark-os/now covers Jetson and Pi rather than Jetson alone. The service set is identical across all five carriers — only the hostname, the device user (jetsonorpi), and the dds-agent serial node differ, so those are stated inline instead of forked into separate pages. The Pi-only packaging split (ark-os-pi-trixie/ark-os-pi-bookworm) and the Jetson-only CLI tools are called out where they apply.Each Pi product gets a short Using ARK-OS landing page carrying its hostname, screenshot, and carrier-specific links, matching the pattern the Jetson carriers use.
The rest of the audit is unchanged: Just a Pi getting-started documents the pre-imaged bundle state, its flashing guide leads with the ark_pi_image golden image, and the Pi6X firmware page drops the hardcoded v1.15.0 link for the releases page and
flash_firmware.sh.Two URLs change (the Pi6X
ark-servicespages) and both have redirects. All 860 relative links resolve and every page is reachable from SUMMARY.