DOCS-2664 / 27 / Docs 2664 advanced power management options are not explained

[DjP-iX]

Adds information better explaining differentiating the APM level options to address reader questions.

Thanks for contributing to TrueNAS documentation! By opening a Pull Request, you're acknowledging that your changes will be distributed under the Creative Commons 4.0 license.

[bugclerk]

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

[github-actions]

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 96 issues found in changed files - 3 errors, 4 warnings, 89 suggestions

Changed files with issues:

content/SCALE/Storage/Pools/ManagePools.md (55 issues)

• Lines 23, 290, 310 - suggestion: Keep sentences under 30 words
• Lines 31, 42, 82, 118, 181, 195, 201, 243, 259, 280, 308, 345, 382, 391 - suggestion: Use active voice instead of passive voice
• Lines 37, 41, 42, 44 - suggestion: Spell out 'TRIM' on first use
• Line 42 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
• Line 84 - suggestion: Use 'rollback' instead of 'roll back'
• Lines 144, 310 - suggestion: Use Oxford comma before 'and' in lists
• Lines 150, 172, 176, 177, 179, 183, 190, 193, 197, 205, 391, 401 - suggestion: Spell out 'RAIDZ' on first use
• Lines 241, 242 - suggestion: Spell out 'RAID' on first use
• Line 374 - suggestion: Spell out 'SLOG' on first use

content/SCALE/Storage/Disks/DisksScreen.md (41 issues)

• Lines 26, 100, 109 - suggestion: Keep sentences under 30 words
• Line 26 - suggestion: Spell out 'RPM' on first use
• Line 26 - suggestion: Spell out 'HDD' on first use
• Lines 52, 54 - error: Don't add '(s)' to a singular noun. Use plural instead.
• Lines 59, 67, 68, 100, 109, 118, 146 - suggestion: Use active voice instead of passive voice
• Lines 67, 146 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
• Lines 68, 158 - suggestion: Don't use language (such as 'Disabled') that defines people by their disability.
• Lines 116, 120, 122 - suggestion: Spell out 'PSID' on first use
• Line 118 - warning: Use first person (such as 'I') sparingly.
• Line 118 - suggestion: Avoid using 'will' - use present tense instead of future tense
• Lines 124, 160 - warning: Use first person (such as ' I') sparingly.
• Line 124 - warning: In general, don't use an ellipsis.
• Line 131 - error: 'the' is repeated!
• Lines 150, 151 - suggestion: Spell out 'APM' on first use

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

[github-actions]

Vale Style Guide Issues

📊 Summary: 96 issues found in changed files - 3 errors, 4 warnings, 89 suggestions

Changed files with issues:

content/SCALE/Storage/Pools/ManagePools.md (55 issues)

• Lines 23, 290, 310 - suggestion: Keep sentences under 30 words
• Lines 31, 42, 82, 118, 181, 195, 201, 243, 259, 280, 308, 345, 382, 391 - suggestion: Use active voice instead of passive voice
• Lines 37, 41, 42, 44 - suggestion: Spell out 'TRIM' on first use
• Line 42 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
• Line 84 - suggestion: Use 'rollback' instead of 'roll back'
• Lines 144, 310 - suggestion: Use Oxford comma before 'and' in lists
• Lines 150, 172, 176, 177, 179, 183, 190, 193, 197, 205, 391, 401 - suggestion: Spell out 'RAIDZ' on first use
• Lines 241, 242 - suggestion: Spell out 'RAID' on first use
• Line 374 - suggestion: Spell out 'SLOG' on first use

content/SCALE/Storage/Disks/DisksScreen.md (41 issues)

• Lines 26, 100, 109 - suggestion: Keep sentences under 30 words
• Line 26 - suggestion: Spell out 'RPM' on first use
• Line 26 - suggestion: Spell out 'HDD' on first use
• Lines 52, 54 - error: Don't add '(s)' to a singular noun. Use plural instead.
• Lines 59, 67, 68, 100, 109, 118, 146 - suggestion: Use active voice instead of passive voice
• Lines 67, 146 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
• Lines 68, 158 - suggestion: Don't use language (such as 'Disabled') that defines people by their disability.
• Lines 116, 120, 122 - suggestion: Spell out 'PSID' on first use
• Line 118 - warning: Use first person (such as 'I') sparingly.
• Line 118 - suggestion: Avoid using 'will' - use present tense instead of future tense
• Lines 124, 160 - warning: Use first person (such as ' I') sparingly.
• Line 124 - warning: In general, don't use an ellipsis.
• Line 131 - error: 'the' is repeated!
• Lines 150, 151 - suggestion: Spell out 'APM' on first use

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