Changelog - April 4, 2026

Documentation Restructure

1) Reworked the storage expansion overview

• Updated docs/Storage_Expansion_Guide.md
• Updated docs/en/Storage_Expansion_Guide.md
• Reframed the main flow as:
  • identify whether the system is ext4 or squashfs
  • then choose between root partition expansion, a separate data partition, or extroot
• Added a Raspberry Pi ext4 root expansion path, including:
  • backup
  • cleanup of stale fstab.overlay
  • partition inspection with parted
  • offline expansion recommendation
  • online expansion with the official OpenWrt script
  • verification steps and post-expansion guidance

2) Narrowed the scope of the extroot guide

• Updated docs/ExtendOverlaySize.md
• Updated docs/en/ExtendOverlaySize.md
• Made it explicit that this guide only applies when:
  • the router is still on squashfs + overlay
  • writable package space in /overlay is the real limitation
• Added explicit warnings:
  • do not use the extroot guide on an ext4 root filesystem
  • the critical part of extroot is migrating the old overlay, not simply mounting a new partition

3) Removed stale partition examples from the maintenance guide

• Updated docs/System_Maintenance.md
• Updated docs/en/System_Maintenance.md
• Removed the old fixed p3 / overlay / 10GB example so the doc no longer conflicts with real image layouts
• Replaced storage guidance with:
  • inspect mount, df -h, block info, and uci show fstab first
  • then jump to the primary storage guide
• Updated the smart backup description to match the current strategy:
  • create backups only when configuration changes
  • keep 3 local archives
  • keep 7 archives in GitHub

4) Added a “no duplicate procedures” rule to the documentation guide

• Updated docs/Documentation_Style_Guide.md
• Updated docs/en/Documentation_Style_Guide.md
• Added a rule that:
  • one topic should have one primary tutorial
  • other docs should provide scope guidance, risk notes, and links
  • the same step-by-step workflow should not be duplicated across multiple pages

5) Updated the README storage entry wording

• Updated README.md
• Updated README_EN.md
• The storage section now says:
  • identify the system type first, then choose the path
  • extroot is for squashfs + overlay only

Result

• Readers are now guided to identify the system type before running expansion commands
• Raspberry Pi users on ext4 images can find the correct route directly
• extroot is no longer presented as a generic answer
• The division of responsibility between the storage guide, maintenance guide, and README is clearer, with less repeated content