docs(pi): audit and rewrite Pi6X Flow and Just a Pi docs - #54
Draft
dakejahl wants to merge 1 commit 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 |
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
Ports the Jetson docs audit (#53) to the two Pi products: ARK-OS pages rewritten against the current deb-based install, Pi-flavored ARK-UI screenshots, and page reordering so setup flows first. Just a Pi gains its missing ARK-OS section and a real bundle story.
Problem
Both products' ARK Services pages still 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 comment 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.
Solution
ARK-OS pages now match the package reality (system services as
pi, current service list including go2rtc and pointperfect, install/update viainstall_ark_os.sh, config-reset warning, CLI tools) with fresh screenshots captured from the current UI. Just a Pi getting-started documents the pre-imaged bundle state (ARK-OS installed,pi/pi,just-a-pihostname, first-boot hotspot fallback) and its flashing guide leads with the ark_pi_image golden image, keeping the manual Imager flow as the fallback. The Pi6X firmware page drops the hardcoded v1.15.0 link in favor of the releases page and theflash_firmware.shtool on PATH. Existing URLs are preserved; only SUMMARY order/titles changed plus the new Just a Pi ARK-OS pages.