docs(penta-sata-hat): add Debian trixie fresh install note for top board package#1796
Merged
Milir-Radxa merged 1 commit intoJun 4, 2026
Conversation
…ard package The rockpi-penta .deb package does not install cleanly on a fresh Raspberry Pi OS (Debian trixie / Debian 13) system. Systems upgraded from Debian 12 usually install the package without issues, but a fresh trixie install may fail. The existing note only covered post-install runtime symptoms on trixie; this change extends the note to also call out the fresh install failure scenario and references both radxa-docs#1792 (fresh install) and radxa-docs#1540 (post-install) for known workarounds. Fixes radxa-docs#1792
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
2 participants
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
rockpi-pentaon a clean Trixie / Debian 13 system.Context / Source
This docs-only change is triggered by GitHub issue #1792, opened on 2026-06-02 by a user on the sata-hat-top-board docs page.
User report (verbatim):
The existing docs note (added for the post-install symptoms covered by #1540) was positioned after the
apt installcommand, which implicitly assumed the install step succeeded. Issue #1792 makes it clear the install step itself can fail on a clean Trixie system, so the note now:FileNotFoundError) for users who did manage to install.Change
docs/accessories/storage/penta-sata-hat/sata-hat-top-board.md(中文)i18n/en/docusaurus-plugin-content-docs/current/accessories/storage/penta-sata-hat/sata-hat-top-board.md(English)docs/accessories/storage).What this is NOT
rockpi-pentapackage itself is a third-party / community-maintained tool; the docs only describe the known install/runtime behavior.Validation
python3 scripts/github_pr_guard.py check --repo-path ~/radxa-docs/docs --fetch→ok: true(1 commit, 2 files, bilingual OK, single scope)python3 scripts/github_issue_guard.py check --repo radxa-docs/docs --issue 1792→skip: false(no prior watcher / PR)Fixes #1792