Skip to content

Update Parity Swap process description (to clarify disk replacement order) #495

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DigicoolThings wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update Parity Swap process description (to clarify disk replacement order) #495

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/unraid-os/using-unraid-to/manage-storage/array/replacing-disks-in-array.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -205,7 +205,7 @@ This procedure works for both data drives and %%parity drives|parity-drives%% th

## Parity swap

Parity swap is a special procedure used when you need to replace a data disk with a disk that is larger than your current parity disk. The process moves your current parity disk to the data slot, then installs a new, larger disk as the new parity disk. This ensures your array remains protected and allows for larger data drives in the future.
Parity swap is a special procedure used when you need to replace a data disk with a disk that is larger than your current parity disk. The process installs a new, larger disk as the new parity disk, then installs your previous parity disk to the data slot. This ensures your array remains protected and allows for larger data drives in the future.
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot May 28, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Inconsistency with shared partial needs resolution.

The updated sequence description here is correct and aligns with both the procedure steps (lines 254-256) and the example scenario (line 212). However, the shared partial at docs/unraid-os/using-unraid-to/manage-storage/partials/parity-swap-what.mdx still contains the old sequence: "moves your current parity disk to the data slot, then installs a new, larger disk as the new parity disk."

Please update the shared partial to match this corrected sequence to maintain consistency across the documentation.

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/unraid-os/using-unraid-to/manage-storage/array/replacing-disks-in-array.mdx`
at line 208, The partial
docs/unraid-os/using-unraid-to/manage-storage/partials/parity-swap-what.mdx
still describes the old sequence for a parity swap (saying it "moves your
current parity disk to the data slot, then installs a new, larger disk as the
new parity disk"); update that sentence to match the corrected sequence used in
replacing-disks-in-array.mdx (describe that the process installs a new larger
disk as the new parity disk first, then installs the previous parity disk into a
data slot), keeping wording consistent with the phrasing in
replacing-disks-in-array.mdx around "installs a new, larger disk as the new
parity disk, then installs your previous parity disk to the data slot."


Use a parity swap when your replacement data drive is larger than your current parity disk. This isn't necessary if your new data drive is the same size or smaller than your parity disk.

Expand Down