Skip to content

DOCS-2505 / 27 / DOCS-2505 Storage Tiering - #4613

Merged
micjohnson777 merged 12 commits into
masterfrom
DOCS-2505-Flash-HDD-Toggle
Aug 10, 2026
Merged

DOCS-2505 / 27 / DOCS-2505 Storage Tiering#4613
micjohnson777 merged 12 commits into
masterfrom
DOCS-2505-Flash-HDD-Toggle

Conversation

@tonyriv3

@tonyriv3 tonyriv3 commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

This PR adds tutorials and how-tos for storage tiering and local pool migration. It also updates references to include storage tiering functions.

@bugclerk

bugclerk commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

Jira URL: https://ixsystemsinc.atlassian.net/browse/DOCS-2505

@bugclerk bugclerk changed the title DOCS-2505 Storage Tiering DOCS-2505 / 27 / DOCS-2505 Storage Tiering Jun 1, 2026
@github-actions

github-actions Bot commented Jun 1, 2026 •
edited
Loading

Copy link
Copy Markdown
Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 271 issues found in changed files - 33 errors, 5 warnings, 233 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (46 issues)

  • Lines 19, 35, 75 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 35, 150, 191 - error: Use 'could' instead of 'may'
  • Lines 40, 41, 44, 46, 64, 66, 67, 75, 88, 150 - suggestion: Use active voice instead of passive voice
  • Lines 48, 50, 52 - error: Remove the spaces around ' — '.
  • Line 70 - error: Use 'clear' instead of 'uncheck'
  • Lines 75, 217 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 105 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 121 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 128 - suggestion: Spell out 'UNIX' on first use
  • Line 134 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 134 - suggestion: Use Title Case for headings
  • Line 147 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 157 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 164 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 173 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 180 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.
  • Line 217 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/StorageDashboardScreens.md (43 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Line 64 - error: Use 'could' instead of 'may'
  • Lines 64, 80, 83, 134, 139, 173, 183, 208, 265, 299, 316 - suggestion: Use active voice instead of passive voice
  • Line 65 - error: Avoid possessive forms ('job's'). Rephrase to avoid using apostrophes for possession.
  • Line 68 - error: Use 'after' instead of 'Once'
  • Lines 68, 83 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 79, 225 - suggestion: Keep sentences under 30 words
  • Lines 80, 81 - suggestion: Use 'backup' instead of 'back up'
  • Line 87 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 133, 138, 142, 261 - suggestion: Spell out 'TRIM' on first use
  • Line 170 - suggestion: Use Title Case for headings
  • Line 217 - suggestion: Spell out 'RAID' on first use
  • Line 288 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/LocalPoolMigration.md (32 issues)

  • Line 15 - suggestion: Keep sentences under 30 words
  • Lines 21, 22, 23, 24, 27, 46, 47, 61, 121 - suggestion: Use active voice instead of passive voice
  • Lines 29, 31 - error: Remove the spaces around ' — '.
  • Line 76 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 92 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 99 - suggestion: Spell out 'UNIX' on first use
  • Line 105 - suggestion: Use Title Case for headings
  • Line 105 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 118 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Lines 121, 162 - error: Use 'could' instead of 'may'
  • Line 128 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 135 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 144 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 151 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Storage/StorageTiering.md (16 issues)

  • Line 19 - suggestion: Spell out 'HDD' on first use
  • Line 22 - suggestion: Use Oxford comma before 'and' in lists
  • Lines 37, 84, 94 - error: Use 'after' instead of 'Once'
  • Lines 37, 54 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 50, 104 - suggestion: Keep sentences under 30 words
  • Lines 86, 96 - suggestion: Use active voice instead of passive voice
  • Lines 94, 96 - suggestion: Spell out 'UNIX' on first use
  • Line 110 - error: Use 'could' instead of 'may'

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@github-actions

github-actions Bot commented Jun 1, 2026 •
edited
Loading

Copy link
Copy Markdown
Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 271 issues found in changed files - 33 errors, 5 warnings, 233 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (46 issues)

  • Lines 19, 35, 75 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 35, 150, 191 - error: Use 'could' instead of 'may'
  • Lines 40, 41, 44, 46, 64, 66, 67, 75, 88, 150 - suggestion: Use active voice instead of passive voice
  • Lines 48, 50, 52 - error: Remove the spaces around ' — '.
  • Line 70 - error: Use 'clear' instead of 'uncheck'
  • Lines 75, 217 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 105 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 121 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 128 - suggestion: Spell out 'UNIX' on first use
  • Line 134 - suggestion: Use Title Case for headings
  • Line 134 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 147 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 157 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 164 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 173 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 180 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.
  • Line 217 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/StorageDashboardScreens.md (43 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Line 64 - error: Use 'could' instead of 'may'
  • Lines 64, 80, 83, 134, 139, 173, 183, 208, 265, 299, 316 - suggestion: Use active voice instead of passive voice
  • Line 65 - error: Avoid possessive forms ('job's'). Rephrase to avoid using apostrophes for possession.
  • Line 68 - error: Use 'after' instead of 'Once'
  • Lines 68, 83 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 79, 225 - suggestion: Keep sentences under 30 words
  • Lines 80, 81 - suggestion: Use 'backup' instead of 'back up'
  • Line 87 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 133, 138, 142, 261 - suggestion: Spell out 'TRIM' on first use
  • Line 170 - suggestion: Use Title Case for headings
  • Line 217 - suggestion: Spell out 'RAID' on first use
  • Line 288 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/LocalPoolMigration.md (32 issues)

  • Line 15 - suggestion: Keep sentences under 30 words
  • Lines 21, 22, 23, 24, 27, 46, 47, 61, 121 - suggestion: Use active voice instead of passive voice
  • Lines 29, 31 - error: Remove the spaces around ' — '.
  • Line 76 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 92 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 99 - suggestion: Spell out 'UNIX' on first use
  • Line 105 - suggestion: Use Title Case for headings
  • Line 105 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 118 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Lines 121, 162 - error: Use 'could' instead of 'may'
  • Line 128 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 135 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 144 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 151 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Storage/StorageTiering.md (16 issues)

  • Line 19 - suggestion: Spell out 'HDD' on first use
  • Line 22 - suggestion: Use Oxford comma before 'and' in lists
  • Lines 37, 84, 94 - error: Use 'after' instead of 'Once'
  • Lines 37, 54 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 50, 104 - suggestion: Keep sentences under 30 words
  • Lines 86, 96 - suggestion: Use active voice instead of passive voice
  • Lines 94, 96 - suggestion: Spell out 'UNIX' on first use
  • Line 110 - error: Use 'could' instead of 'may'

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@github-actions

github-actions Bot commented Jun 1, 2026 •
edited
Loading

Copy link
Copy Markdown
Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 271 issues found in changed files - 33 errors, 5 warnings, 233 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (46 issues)

  • Lines 19, 35, 75 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 35, 150, 191 - error: Use 'could' instead of 'may'
  • Lines 40, 41, 44, 46, 64, 66, 67, 75, 88, 150 - suggestion: Use active voice instead of passive voice
  • Lines 48, 50, 52 - error: Remove the spaces around ' — '.
  • Line 70 - error: Use 'clear' instead of 'uncheck'
  • Lines 75, 217 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 105 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 121 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 128 - suggestion: Spell out 'UNIX' on first use
  • Line 134 - suggestion: Use Title Case for headings
  • Line 134 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 147 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 157 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 164 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 173 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 180 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.
  • Line 217 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/StorageDashboardScreens.md (43 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Line 64 - error: Use 'could' instead of 'may'
  • Lines 64, 80, 83, 134, 139, 173, 183, 208, 265, 299, 316 - suggestion: Use active voice instead of passive voice
  • Line 65 - error: Avoid possessive forms ('job's'). Rephrase to avoid using apostrophes for possession.
  • Line 68 - error: Use 'after' instead of 'Once'
  • Lines 68, 83 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 79, 225 - suggestion: Keep sentences under 30 words
  • Lines 80, 81 - suggestion: Use 'backup' instead of 'back up'
  • Line 87 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 133, 138, 142, 261 - suggestion: Spell out 'TRIM' on first use
  • Line 170 - suggestion: Use Title Case for headings
  • Line 217 - suggestion: Spell out 'RAID' on first use
  • Line 288 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/LocalPoolMigration.md (32 issues)

  • Line 15 - suggestion: Keep sentences under 30 words
  • Lines 21, 22, 23, 24, 27, 46, 47, 61, 121 - suggestion: Use active voice instead of passive voice
  • Lines 29, 31 - error: Remove the spaces around ' — '.
  • Line 76 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 92 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 99 - suggestion: Spell out 'UNIX' on first use
  • Line 105 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 105 - suggestion: Use Title Case for headings
  • Line 118 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Lines 121, 162 - error: Use 'could' instead of 'may'
  • Line 128 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 135 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 144 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 151 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Storage/StorageTiering.md (16 issues)

  • Line 19 - suggestion: Spell out 'HDD' on first use
  • Line 22 - suggestion: Use Oxford comma before 'and' in lists
  • Lines 37, 84, 94 - error: Use 'after' instead of 'Once'
  • Lines 37, 54 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 50, 104 - suggestion: Keep sentences under 30 words
  • Lines 86, 96 - suggestion: Use active voice instead of passive voice
  • Lines 94, 96 - suggestion: Spell out 'UNIX' on first use
  • Line 110 - error: Use 'could' instead of 'may'

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@github-actions

github-actions Bot commented Jun 1, 2026 •
edited
Loading

Copy link
Copy Markdown
Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 271 issues found in changed files - 33 errors, 5 warnings, 233 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (46 issues)

  • Lines 19, 35, 75 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 35, 150, 191 - error: Use 'could' instead of 'may'
  • Lines 40, 41, 44, 46, 64, 66, 67, 75, 88, 150 - suggestion: Use active voice instead of passive voice
  • Lines 48, 50, 52 - error: Remove the spaces around ' — '.
  • Line 70 - error: Use 'clear' instead of 'uncheck'
  • Lines 75, 217 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 105 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 121 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 128 - suggestion: Spell out 'UNIX' on first use
  • Line 134 - suggestion: Use Title Case for headings
  • Line 134 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 147 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 157 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 164 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 173 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 180 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.
  • Line 217 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/StorageDashboardScreens.md (43 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Line 64 - error: Use 'could' instead of 'may'
  • Lines 64, 80, 83, 134, 139, 173, 183, 208, 265, 299, 316 - suggestion: Use active voice instead of passive voice
  • Line 65 - error: Avoid possessive forms ('job's'). Rephrase to avoid using apostrophes for possession.
  • Line 68 - error: Use 'after' instead of 'Once'
  • Lines 68, 83 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 79, 225 - suggestion: Keep sentences under 30 words
  • Lines 80, 81 - suggestion: Use 'backup' instead of 'back up'
  • Line 87 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 133, 138, 142, 261 - suggestion: Spell out 'TRIM' on first use
  • Line 170 - suggestion: Use Title Case for headings
  • Line 217 - suggestion: Spell out 'RAID' on first use
  • Line 288 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/LocalPoolMigration.md (32 issues)

  • Line 15 - suggestion: Keep sentences under 30 words
  • Lines 21, 22, 23, 24, 27, 46, 47, 61, 121 - suggestion: Use active voice instead of passive voice
  • Lines 29, 31 - error: Remove the spaces around ' — '.
  • Line 76 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 92 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 99 - suggestion: Spell out 'UNIX' on first use
  • Line 105 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 105 - suggestion: Use Title Case for headings
  • Line 118 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Lines 121, 162 - error: Use 'could' instead of 'may'
  • Line 128 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 135 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 144 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 151 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Storage/StorageTiering.md (16 issues)

  • Line 19 - suggestion: Spell out 'HDD' on first use
  • Line 22 - suggestion: Use Oxford comma before 'and' in lists
  • Lines 37, 84, 94 - error: Use 'after' instead of 'Once'
  • Lines 37, 54 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 50, 104 - suggestion: Keep sentences under 30 words
  • Lines 86, 96 - suggestion: Use active voice instead of passive voice
  • Lines 94, 96 - suggestion: Spell out 'UNIX' on first use
  • Line 110 - error: Use 'could' instead of 'may'

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@github-actions

github-actions Bot commented Jun 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 271 issues found in changed files - 33 errors, 5 warnings, 233 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (46 issues)

  • Lines 19, 35, 75 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 35, 150, 191 - error: Use 'could' instead of 'may'
  • Lines 40, 41, 44, 46, 64, 66, 67, 75, 88, 150 - suggestion: Use active voice instead of passive voice
  • Lines 48, 50, 52 - error: Remove the spaces around ' — '.
  • Line 70 - error: Use 'clear' instead of 'uncheck'
  • Lines 75, 217 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 105 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 121 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 128 - suggestion: Spell out 'UNIX' on first use
  • Line 134 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 134 - suggestion: Use Title Case for headings
  • Line 147 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 157 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 164 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 173 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 180 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.
  • Line 217 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/StorageDashboardScreens.md (43 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Line 64 - error: Use 'could' instead of 'may'
  • Lines 64, 80, 83, 134, 139, 173, 183, 208, 265, 299, 316 - suggestion: Use active voice instead of passive voice
  • Line 65 - error: Avoid possessive forms ('job's'). Rephrase to avoid using apostrophes for possession.
  • Line 68 - error: Use 'after' instead of 'Once'
  • Lines 68, 83 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 79, 225 - suggestion: Keep sentences under 30 words
  • Lines 80, 81 - suggestion: Use 'backup' instead of 'back up'
  • Line 87 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 133, 138, 142, 261 - suggestion: Spell out 'TRIM' on first use
  • Line 170 - suggestion: Use Title Case for headings
  • Line 217 - suggestion: Spell out 'RAID' on first use
  • Line 288 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/LocalPoolMigration.md (32 issues)

  • Line 15 - suggestion: Keep sentences under 30 words
  • Lines 21, 22, 23, 24, 27, 46, 47, 61, 121 - suggestion: Use active voice instead of passive voice
  • Lines 29, 31 - error: Remove the spaces around ' — '.
  • Line 76 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 92 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 99 - suggestion: Spell out 'UNIX' on first use
  • Line 105 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 105 - suggestion: Use Title Case for headings
  • Line 118 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Lines 121, 162 - error: Use 'could' instead of 'may'
  • Line 128 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 135 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 144 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 151 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Storage/StorageTiering.md (16 issues)

  • Line 19 - suggestion: Spell out 'HDD' on first use
  • Line 22 - suggestion: Use Oxford comma before 'and' in lists
  • Lines 37, 84, 94 - error: Use 'after' instead of 'Once'
  • Lines 37, 54 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 50, 104 - suggestion: Keep sentences under 30 words
  • Lines 86, 96 - suggestion: Use active voice instead of passive voice
  • Lines 94, 96 - suggestion: Spell out 'UNIX' on first use
  • Line 110 - error: Use 'could' instead of 'may'

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@github-actions

github-actions Bot commented Jun 10, 2026 •
edited
Loading

Copy link
Copy Markdown
Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 274 issues found in changed files - 33 errors, 5 warnings, 236 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (46 issues)

  • Lines 19, 35, 75 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 35, 150, 191 - error: Use 'could' instead of 'may'
  • Lines 40, 41, 44, 46, 64, 66, 67, 75, 88, 150 - suggestion: Use active voice instead of passive voice
  • Lines 48, 50, 52 - error: Remove the spaces around ' — '.
  • Line 70 - error: Use 'clear' instead of 'uncheck'
  • Lines 75, 217 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 105 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 121 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 128 - suggestion: Spell out 'UNIX' on first use
  • Line 134 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 134 - suggestion: Use Title Case for headings
  • Line 147 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 157 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 164 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 173 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 180 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.
  • Line 217 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/StorageDashboardScreens.md (43 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Line 64 - error: Use 'could' instead of 'may'
  • Lines 64, 80, 83, 134, 139, 173, 183, 208, 265, 299, 316 - suggestion: Use active voice instead of passive voice
  • Line 65 - error: Avoid possessive forms ('job's'). Rephrase to avoid using apostrophes for possession.
  • Line 68 - error: Use 'after' instead of 'Once'
  • Lines 68, 83 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 79, 225 - suggestion: Keep sentences under 30 words
  • Lines 80, 81 - suggestion: Use 'backup' instead of 'back up'
  • Line 87 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 133, 138, 142, 261 - suggestion: Spell out 'TRIM' on first use
  • Line 170 - suggestion: Use Title Case for headings
  • Line 217 - suggestion: Spell out 'RAID' on first use
  • Line 288 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/LocalPoolMigration.md (32 issues)

  • Line 15 - suggestion: Keep sentences under 30 words
  • Lines 21, 22, 23, 24, 27, 46, 47, 61, 121 - suggestion: Use active voice instead of passive voice
  • Lines 29, 31 - error: Remove the spaces around ' — '.
  • Line 76 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 92 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 99 - suggestion: Spell out 'UNIX' on first use
  • Line 105 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 105 - suggestion: Use Title Case for headings
  • Line 118 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Lines 121, 162 - error: Use 'could' instead of 'may'
  • Line 128 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 135 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 144 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 151 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Storage/StorageTiering.md (15 issues)

  • Lines 19, 55 - suggestion: Spell out 'HDD' on first use
  • Line 27 - suggestion: Use Oxford comma before 'and' in lists
  • Lines 42, 93, 103 - error: Use 'after' instead of 'Once'
  • Lines 42, 59 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 95, 105 - suggestion: Use active voice instead of passive voice
  • Lines 103, 105 - suggestion: Spell out 'UNIX' on first use
  • Line 113 - suggestion: Keep sentences under 30 words
  • Line 119 - error: Use 'could' instead of 'may'

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

static/includes/FusionPoolsIntro.md (4 issues)

  • Lines 7, 9 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@tonyriv3
tonyriv3 marked this pull request as ready for review August 5, 2026 17:53
@tonyriv3
tonyriv3 requested a review from a team as a code owner August 5, 2026 17:53
@github-actions

github-actions Bot commented Aug 5, 2026 •
edited
Loading

Copy link
Copy Markdown
Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 274 issues found in changed files - 33 errors, 5 warnings, 236 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (46 issues)

  • Lines 19, 35, 75 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 35, 150, 191 - error: Use 'could' instead of 'may'
  • Lines 40, 41, 44, 46, 64, 66, 67, 75, 88, 150 - suggestion: Use active voice instead of passive voice
  • Lines 48, 50, 52 - error: Remove the spaces around ' — '.
  • Line 70 - error: Use 'clear' instead of 'uncheck'
  • Lines 75, 217 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 105 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 121 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 128 - suggestion: Spell out 'UNIX' on first use
  • Line 134 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 134 - suggestion: Use Title Case for headings
  • Line 147 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 157 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 164 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 173 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 180 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.
  • Line 217 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/StorageDashboardScreens.md (43 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Line 64 - error: Use 'could' instead of 'may'
  • Lines 64, 80, 83, 134, 139, 173, 183, 208, 265, 299, 316 - suggestion: Use active voice instead of passive voice
  • Line 65 - error: Avoid possessive forms ('job's'). Rephrase to avoid using apostrophes for possession.
  • Line 68 - error: Use 'after' instead of 'Once'
  • Lines 68, 83 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 79, 225 - suggestion: Keep sentences under 30 words
  • Lines 80, 81 - suggestion: Use 'backup' instead of 'back up'
  • Line 87 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 133, 138, 142, 261 - suggestion: Spell out 'TRIM' on first use
  • Line 170 - suggestion: Use Title Case for headings
  • Line 217 - suggestion: Spell out 'RAID' on first use
  • Line 288 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/LocalPoolMigration.md (32 issues)

  • Line 15 - suggestion: Keep sentences under 30 words
  • Lines 21, 22, 23, 24, 27, 46, 47, 61, 121 - suggestion: Use active voice instead of passive voice
  • Lines 29, 31 - error: Remove the spaces around ' — '.
  • Line 76 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 92 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 99 - suggestion: Spell out 'UNIX' on first use
  • Line 105 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 105 - suggestion: Use Title Case for headings
  • Line 118 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Lines 121, 162 - error: Use 'could' instead of 'may'
  • Line 128 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 135 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 144 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 151 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Storage/StorageTiering.md (15 issues)

  • Lines 19, 55 - suggestion: Spell out 'HDD' on first use
  • Line 27 - suggestion: Use Oxford comma before 'and' in lists
  • Lines 42, 93, 103 - error: Use 'after' instead of 'Once'
  • Lines 42, 59 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Lines 95, 105 - suggestion: Use active voice instead of passive voice
  • Lines 103, 105 - suggestion: Spell out 'UNIX' on first use
  • Line 113 - suggestion: Keep sentences under 30 words
  • Line 119 - error: Use 'could' instead of 'may'

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

static/includes/FusionPoolsIntro.md (4 issues)

  • Lines 7, 9 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@micjohnson777 micjohnson777 added the Technical Writer Review (MJ) A technical writer is reviewing the PR. label Aug 7, 2026
@micjohnson777
DOCS-2505 Style, Spelling, and Other Changes
f289d56 
This commit creates a snippet for content repeated in the two tutorials.
It makes spelling and other style changes to the general content.
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown

Vale Style Guide Issues

📊 Summary: 252 issues found in changed files - 21 errors, 5 warnings, 226 suggestions

Changed files with issues:

content/SCALE/Shares/SMB/AddManageSMBShares.md (81 issues)

  • Lines 26, 282 - warning: Use first person (such as ' I') sparingly.
  • Line 26 - warning: Don't use end punctuation in headings.
  • Lines 30, 47, 68, 82, 103, 108, 151, 156, 160, 164, 170, 174, 178, 196, 222, 242, 319, 480, 529 - suggestion: Use active voice instead of passive voice
  • Lines 42, 47, 75, 118, 119, 321, 398, 411, 506, 511, 520, 526 - suggestion: Keep sentences under 30 words
  • Line 64 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 129 - error: Use 'filesystem' instead of 'file system'
  • Lines 167, 514 - suggestion: Spell out 'SHARE' on first use
  • Lines 222, 287 - error: Use 'after' instead of 'once'
  • Lines 258, 264, 475 - error: Use 'hostname' instead of 'host name'
  • Line 282 - error: Avoid contractions. Use 'cannot' instead of 'can't'.
  • Lines 307, 308, 325, 326 - suggestion: Spell out 'NTFS' on first use
  • Line 310 - suggestion: Spell out 'FSRVP' on first use
  • Line 313 - suggestion: Spell out 'VUID' on first use
  • Line 372 - error: Use 'filesystem' instead of 'File System'
  • Line 470 - suggestion: Spell out 'YES' on first use

content/SCALE/Storage/StorageDashboardScreens.md (41 issues)

  • Line 30 - suggestion: 'Storage Dashboard' should use sentence-style capitalization.
  • Lines 65, 82, 85, 136, 141, 175, 185, 210, 267, 301, 318 - suggestion: Use active voice instead of passive voice
  • Lines 81, 227 - suggestion: Keep sentences under 30 words
  • Lines 82, 83 - suggestion: Use 'backup' instead of 'back up'
  • Line 85 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 89 - suggestion: Use 'backup' instead of 'Back up'
  • Lines 135, 140, 144, 263 - suggestion: Spell out 'TRIM' on first use
  • Line 172 - suggestion: Use Title Case for headings
  • Line 219 - suggestion: Spell out 'RAID' on first use
  • Line 290 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALE/Storage/Pools/StorageTieringPoolMigration.md (29 issues)

  • Lines 19, 81 - suggestion: Keep sentences under 30 words
  • Lines 19, 28 - suggestion: Spell out 'HDD' on first use
  • Lines 43, 44, 47, 49, 59, 67, 69, 70, 80, 92 - suggestion: Use active voice instead of passive voice
  • Lines 51, 53, 55 - error: Remove the spaces around ' — '.
  • Line 73 - error: Use 'clear' instead of 'uncheck'
  • Line 125 - error: Use 'after' instead of 'Once'

content/SCALE/Storage/Pools/LocalPoolMigration.md (20 issues)

  • Line 16 - suggestion: Keep sentences under 30 words
  • Lines 24, 25, 26, 27, 30, 42, 51, 52, 67 - suggestion: Use active voice instead of passive voice
  • Lines 32, 34 - error: Remove the spaces around ' — '.

content/SCALE/Storage/Pools/PoolCreationWizardScreen.md (18 issues)

  • Line 23 - suggestion: 'Pool Creation Wizard' should use sentence-style capitalization.
  • Lines 48, 56, 97, 100, 104, 166 - suggestion: Use active voice instead of passive voice
  • Line 57 - suggestion: Use Oxford comma before 'and' in lists
  • Line 57 - error: Avoid contractions. Use 'do not' instead of 'Don't'.
  • Line 65 - warning: Use first person (such as ' I') sparingly.
  • Line 65 - warning: Use first person (such as 'I') sparingly.

content/SCALE/Shares/NFS/AddingNFSShares.md (15 issues)

  • Line 25 - error: Use 'filesystem' instead of 'File System'
  • Line 29 - error: Use 'filesystem' instead of 'file system'
  • Lines 86, 87 - suggestion: Spell out 'CIDR' on first use
  • Line 91 - error: Use 'hostname' instead of 'host name'
  • Lines 110, 146 - suggestion: Use active voice instead of passive voice
  • Lines 166, 167, 169 - suggestion: Spell out 'RDMA' on first use
  • Line 187 - suggestion: Keep sentences under 30 words
  • Line 201 - suggestion: Spell out 'ESXI' on first use

content/SCALE/Storage/StorageTiering.md (12 issues)

  • Lines 20, 101 - suggestion: Keep sentences under 30 words
  • Lines 20, 54 - suggestion: Spell out 'HDD' on first use
  • Lines 87, 95 - suggestion: Use active voice instead of passive voice
  • Lines 87, 95 - suggestion: Use the Oxford comma in 'to, performance or regular.'.
  • Lines 93, 95 - suggestion: Spell out 'UNIX' on first use

static/includes/StorageTieringMigrationSequence.md (12 issues)

  • Line 11 - suggestion: 'SMB Share Migration' should use sentence-style capitalization.
  • Line 27 - suggestion: 'NFS Share Migration' should use sentence-style capitalization.
  • Line 34 - suggestion: Spell out 'UNIX' on first use
  • Line 40 - suggestion: Use Title Case for headings
  • Line 40 - suggestion: 'iSCSI / NVMeT / FC Migration' should use sentence-style capitalization.
  • Line 53 - suggestion: 'TrueCloud Backup Tasks Migration' should use sentence-style capitalization.
  • Line 56 - suggestion: Use active voice instead of passive voice
  • Line 62 - suggestion: 'Periodic Snapshot Tasks Migration' should use sentence-style capitalization.
  • Line 68 - suggestion: 'Replication Tasks Migration' should use sentence-style capitalization.
  • Line 76 - suggestion: 'Cloudsync Tasks Migration' should use sentence-style capitalization.
  • Line 82 - suggestion: 'Rsync Tasks Migration' should use sentence-style capitalization.

content/SCALE/Storage/Pools/CreatingPools.md (8 issues)

  • Line 34 - suggestion: Avoid using first-person plural (we, us, our)
  • Line 39 - suggestion: Spell out 'VDEVS' on first use
  • Line 41 - suggestion: Keep sentences under 30 words
  • Lines 41, 50 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/VDEVScreens.md (8 issues)

  • Lines 16, 26 - suggestion: Spell out 'VDEVS' on first use
  • Lines 48, 68 - suggestion: Keep sentences under 30 words
  • Line 68 - suggestion: Spell out 'HDD' on first use
  • Line 79 - suggestion: Use active voice instead of passive voice

content/SCALE/Storage/Pools/ImportPool.md (4 issues)

  • Line 52 - suggestion: Keep sentences under 30 words
  • Line 56 - suggestion: Use active voice instead of passive voice

static/includes/FusionPoolsIntro.md (4 issues)

  • Lines 7, 9 - suggestion: Use active voice instead of passive voice

🔧 To fix: Review the issues above and update your documentation accordingly.

@micjohnson777

micjohnson777 commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

@tonyriv3 ready for your review of changes made. Let me know if you want any reverted.

micjohnson777
micjohnson777 reviewed Aug 7, 2026
View reviewed changes

@micjohnson777 micjohnson777 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Tony, let me know if you want any changes. If you are good with what I've done, I'll approve and merge this PR

@micjohnson777
micjohnson777 merged commit b41dc92 into master Aug 10, 2026
4 checks passed
@micjohnson777
micjohnson777 deleted the DOCS-2505-Flash-HDD-Toggle branch August 10, 2026 15:39
@bugclerk

bugclerk commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

This PR has been merged and conversations have been locked.
If you would like to discuss more about this issue please use our forums or raise a Jira ticket.

@truenas truenas locked as resolved and limited conversation to collaborators Aug 10, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@micjohnson777 micjohnson777 micjohnson777 approved these changes

Assignees

No one assigned

Labels

no-time-tracked Technical Writer Review (MJ) A technical writer is reviewing the PR.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@tonyriv3 @bugclerk @micjohnson777