Skip to content

Document Linux drive detection - #21

Open
owenpkent wants to merge 3 commits into
linux-drive-detectionfrom
linux-detection-docs
Open

owenpkent wants to merge 3 commits into
linux-drive-detectionfrom
linux-detection-docs

Conversation

@owenpkent

@owenpkent owenpkent commented Oct 9, 2026 •

Copy link
Copy Markdown
Owner

Stacked on #19. Merge that first, or merge this into it.

#19 changed how Linux volumes are found but left the docs describing the old behaviour by omission.

  • CHANGELOG: a Fixed entry for reading volumes from /proc/self/mountinfo, the overlay-root case, and the directory-scan fallback.
  • README: the drive panel section now says how Linux cards are found and that the filesystem type is shown. Test count and coverage recounted on this branch.
  • CONTRIBUTING: the hardware-fakes table gains a row for the linux_mounts fixture.

Docs only. Suite on this branch: 408 passed, 8 skipped.

Review follow-ups (2026-10-11)

  • README and the changelog said network mounts stay out of the drive list. NFS and SMB mounts are kept and classified as network volumes so they can be chosen as destinations; only pseudo and system filesystems are filtered, and network volumes are kept out of card detection. Wording corrected.

The changelog had no entry for reading volumes from the mount table, the
README's drive panel section did not say how Linux cards are found, and
CONTRIBUTING's list of hardware fakes lacked the mountinfo fixture.
Recount tests.

@owenpkent owenpkent left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One P3 documentation defect: the new text says network mounts are excluded, although the implementation retains and classifies them. The exact contradiction and correction are inline.

Checked all three changed documents against the identical parent #19 volume implementation, its tests and the drive-panel consumer. The overlay-root fix and directory-scan fallback are described consistently; only the network/system-volume exclusion wording needs correction.

Validation: all 23 inline relative links resolve and git diff --check passes. Parent #19's exact-head volume tests passed locally with one symlink skip, and this head's CI succeeds.

Limits: documentation-only checks. Published test counts were not independently regenerated and no real Linux mounting experiment was performed.

Pinned scope: declared base 2454dca81fdbe821c7e2e8a6888570b0c3de782a, merge base 2454dca81fdbe821c7e2e8a6888570b0c3de782a, head 82e2bd624d863f44b9fc6033ac7fabe2d0a91b1a. Existing discussion and current-head checks were reviewed; no threads were resolved and no formal approval or merge is being issued.

Comment thread README.md Outdated
The drive panel keeps NFS and SMB mounts as network volumes so they can be
chosen as destinations; only pseudo and system filesystems are filtered out,
and network volumes are kept away from card detection. The README and the
changelog entry said network mounts stayed out of the list.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant