Skip to content

Conversation

@DjP-iX
Copy link
Contributor

@DjP-iX DjP-iX commented Nov 26, 2025

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
Copy link
Contributor

@bugclerk bugclerk changed the title Pd 2433 update 2 fa content for behavioral changes PD-2433 / 25.10 / Pd 2433 update 2 fa content for behavioral changes Nov 26, 2025
@github-actions
Copy link

github-actions bot commented Nov 26, 2025

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 181 issues found in changed files - 30 errors, 1 warnings, 150 suggestions

Changed files with issues:

content/SCALEUIReference/SystemSettings/AdvancedSettingsScreen.md (76 issues)

  • Lines 28, 96, 444, 521 - suggestion: Keep sentences under 30 words
  • Line 28 - suggestion: Spell out 'NTS' on first use
  • Lines 28, 180, 431, 433, 472 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Lines 60, 62, 63, 64, 65, 78, 112, 113, 132, 143, 144, 174, 343, 381, 382, 450, 471, 499, 500, 529 - suggestion: Use active voice instead of passive voice
  • Line 96 - suggestion: Spell out 'MOTD' on first use
  • Lines 113, 174, 473 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 123 - suggestion: Spell out 'TSL' on first use
  • Lines 141, 144, 286 - error: Use 'hostname' instead of 'host name'
  • Lines 212, 444 - suggestion: Try to simplify this sentence.
  • Line 233 - error: Use 'filesystem' instead of 'file system'
  • Lines 483, 529 - error: Use 'Controller 1' instead of 'controller a'

content/SCALETutorials/SystemSettings/Advanced/ManageGlobal2FASCALE.md (49 issues)

  • Lines 25, 206 - suggestion: Spell out 'TOTP' on first use
  • Line 25 - suggestion: Spell out 'RFC' on first use
  • Line 37 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 42, 47, 173, 186 - error: Use 'login' instead of 'log in'
  • Lines 42, 47, 173, 186 - suggestion: Use 'login' instead of 'log in'
  • Lines 79, 123 - error: Use 'could' instead of 'may'
  • Lines 84, 85, 103, 132, 140, 151, 167, 176, 182, 186 - suggestion: Use active voice instead of passive voice
  • Lines 134, 151, 167, 186 - suggestion: Avoid using 'will' - use present tense instead of future tense
  • Line 151 - error: Use 'after' instead of 'once'
  • Line 191 - error: Avoid contractions. Use 'do not' instead of 'don't'.
  • Line 194 - suggestion: Use 'login' instead of 'Log in'
  • Line 194 - error: Use 'login' instead of 'Log in'
  • Line 206 - error: Avoid contractions. Use 'you are' instead of 'you're'.
  • Line 208 - suggestion: Use Title Case for headings
  • Line 218 - error: Use 'hostname' instead of 'host name'

content/SCALEUIReference/Credentials/UsersScreen.md (32 issues)

  • Lines 13, 26, 139, 144, 149, 202 - suggestion: Use active voice instead of passive voice
  • Lines 90, 94 - suggestion: Keep sentences under 30 words
  • Lines 106, 144, 214 - error: Use 'login' instead of 'log in'
  • Lines 106, 144, 214 - suggestion: Use 'login' instead of 'log in'
  • Line 190 - error: 'edit' is repeated!

content/SCALETutorials/Credentials/ManageUsers.md (17 issues)

  • Line 56 - suggestion: Spell out 'UID' on first use
  • Lines 95, 128, 135, 151 - suggestion: Use active voice instead of passive voice
  • Line 95 - warning: Use first person (such as 'My') sparingly.
  • Line 151 - error: Use 'login' instead of 'log in'
  • Line 151 - suggestion: Use 'login' instead of 'log in'

content/SCALEUIReference/TopToolbar/Settings/2FAScreenSCALE.md (7 issues)

  • Line 23 - suggestion: Spell out 'URI' on first use
  • Line 27 - error: Avoid possessive forms ('user's'). Rephrase to avoid using apostrophes for possession.
  • Line 32 - suggestion: Use active voice instead of passive voice
  • Line 32 - suggestion: Avoid using 'will' - use present tense instead of future tense

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

@github-actions
Copy link

github-actions bot commented Nov 26, 2025

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 173 issues found in changed files - 27 errors, 1 warnings, 145 suggestions

Changed files with issues:

content/SCALEUIReference/SystemSettings/AdvancedSettingsScreen.md (76 issues)

  • Lines 28, 96, 444, 521 - suggestion: Keep sentences under 30 words
  • Line 28 - suggestion: Spell out 'NTS' on first use
  • Lines 28, 180, 431, 433, 472 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Lines 60, 62, 63, 64, 65, 78, 112, 113, 132, 143, 144, 174, 343, 381, 382, 450, 471, 499, 500, 529 - suggestion: Use active voice instead of passive voice
  • Line 96 - suggestion: Spell out 'MOTD' on first use
  • Lines 113, 174, 473 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 123 - suggestion: Spell out 'TSL' on first use
  • Lines 141, 144, 286 - error: Use 'hostname' instead of 'host name'
  • Lines 212, 444 - suggestion: Try to simplify this sentence.
  • Line 233 - error: Use 'filesystem' instead of 'file system'
  • Lines 483, 529 - error: Use 'Controller 1' instead of 'controller a'

content/SCALETutorials/SystemSettings/Advanced/ManageGlobal2FASCALE.md (42 issues)

  • Lines 25, 206 - suggestion: Spell out 'TOTP' on first use
  • Line 25 - suggestion: Spell out 'RFC' on first use
  • Line 37 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 42, 47, 173, 186 - error: Use 'login' instead of 'log in'
  • Lines 42, 47, 173, 186 - suggestion: Use 'login' instead of 'log in'
  • Lines 84, 85, 103, 132, 140, 151, 167, 176, 182, 186 - suggestion: Use active voice instead of passive voice
  • Line 151 - error: Use 'after' instead of 'once'
  • Line 194 - suggestion: Use 'login' instead of 'Log in'
  • Line 194 - error: Use 'login' instead of 'Log in'
  • Line 206 - error: Avoid contractions. Use 'you are' instead of 'you're'.
  • Line 208 - suggestion: Use Title Case for headings
  • Line 218 - error: Use 'hostname' instead of 'host name'

content/SCALEUIReference/Credentials/UsersScreen.md (32 issues)

  • Lines 13, 26, 139, 144, 149, 202 - suggestion: Use active voice instead of passive voice
  • Lines 90, 94 - suggestion: Keep sentences under 30 words
  • Lines 106, 144, 214 - suggestion: Use 'login' instead of 'log in'
  • Lines 106, 144, 214 - error: Use 'login' instead of 'log in'
  • Line 190 - error: 'edit' is repeated!

content/SCALETutorials/Credentials/ManageUsers.md (17 issues)

  • Line 56 - suggestion: Spell out 'UID' on first use
  • Lines 95, 128, 135, 151 - suggestion: Use active voice instead of passive voice
  • Line 95 - warning: Use first person (such as 'My') sparingly.
  • Line 151 - suggestion: Use 'login' instead of 'log in'
  • Line 151 - error: Use 'login' instead of 'log in'

content/SCALEUIReference/TopToolbar/Settings/2FAScreenSCALE.md (6 issues)

  • Line 23 - suggestion: Spell out 'URI' on first use
  • Line 27 - error: Avoid possessive forms ('user's'). Rephrase to avoid using apostrophes for possession.
  • Line 32 - suggestion: Use active voice instead of passive voice

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

@DjP-iX DjP-iX marked this pull request as ready for review November 26, 2025 18:02
@DjP-iX DjP-iX requested a review from a team as a code owner November 26, 2025 18:02
@linzi-ix linzi-ix added the Technical Writer Review (LM) A technical writer is reviewing the PR. label Dec 1, 2025
@github-actions
Copy link

github-actions bot commented Dec 1, 2025

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 178 issues found in changed files - 27 errors, 1 warnings, 150 suggestions

Changed files with issues:

content/SCALEUIReference/SystemSettings/AdvancedSettingsScreen.md (76 issues)

  • Lines 28, 96, 444, 521 - suggestion: Keep sentences under 30 words
  • Line 28 - suggestion: Spell out 'NTS' on first use
  • Lines 28, 180, 431, 433, 472 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Lines 60, 62, 63, 64, 65, 78, 112, 113, 132, 143, 144, 174, 343, 381, 382, 450, 471, 499, 500, 529 - suggestion: Use active voice instead of passive voice
  • Line 96 - suggestion: Spell out 'MOTD' on first use
  • Lines 113, 174, 473 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 123 - suggestion: Spell out 'TSL' on first use
  • Lines 141, 144, 286 - error: Use 'hostname' instead of 'host name'
  • Lines 212, 444 - suggestion: Try to simplify this sentence.
  • Line 233 - error: Use 'filesystem' instead of 'file system'
  • Lines 483, 529 - error: Use 'Controller 1' instead of 'controller a'

content/SCALETutorials/SystemSettings/Advanced/ManageGlobal2FASCALE.md (42 issues)

  • Lines 25, 206 - suggestion: Spell out 'TOTP' on first use
  • Line 25 - suggestion: Spell out 'RFC' on first use
  • Line 37 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 42, 47, 173, 186 - suggestion: Use 'login' instead of 'log in'
  • Lines 42, 47, 173, 186 - error: Use 'login' instead of 'log in'
  • Lines 84, 85, 103, 132, 140, 151, 167, 176, 182, 186 - suggestion: Use active voice instead of passive voice
  • Line 151 - error: Use 'after' instead of 'once'
  • Line 194 - suggestion: Use 'login' instead of 'Log in'
  • Line 194 - error: Use 'login' instead of 'Log in'
  • Line 206 - error: Avoid contractions. Use 'you are' instead of 'you're'.
  • Line 208 - suggestion: Use Title Case for headings
  • Line 218 - error: Use 'hostname' instead of 'host name'

content/SCALEUIReference/Credentials/UsersScreen.md (35 issues)

  • Lines 13, 26, 139, 144, 149, 185, 203 - suggestion: Use active voice instead of passive voice
  • Lines 90, 94 - suggestion: Keep sentences under 30 words
  • Lines 106, 144, 215 - suggestion: Use 'login' instead of 'log in'
  • Lines 106, 144, 215 - error: Use 'login' instead of 'log in'
  • Line 185 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 191 - error: 'edit' is repeated!

content/SCALETutorials/Credentials/ManageUsers.md (19 issues)

  • Line 56 - suggestion: Spell out 'UID' on first use
  • Lines 66, 96, 129, 136, 152 - suggestion: Use active voice instead of passive voice
  • Line 96 - warning: Use first person (such as 'My') sparingly.
  • Line 152 - suggestion: Use 'login' instead of 'log in'
  • Line 152 - error: Use 'login' instead of 'log in'

content/SCALEUIReference/TopToolbar/Settings/2FAScreenSCALE.md (6 issues)

  • Line 23 - suggestion: Spell out 'URI' on first use
  • Line 27 - error: Avoid possessive forms ('user's'). Rephrase to avoid using apostrophes for possession.
  • Line 32 - suggestion: Use active voice instead of passive voice

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

@github-actions
Copy link

github-actions bot commented Dec 1, 2025

Vale Style Guide Issues

📊 Summary: 176 issues found in changed files - 25 errors, 1 warnings, 150 suggestions

Changed files with issues:

content/SCALEUIReference/SystemSettings/AdvancedSettingsScreen.md (76 issues)

  • Lines 28, 96, 444, 521 - suggestion: Keep sentences under 30 words
  • Line 28 - suggestion: Spell out 'NTS' on first use
  • Lines 28, 180, 431, 433, 472 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Lines 60, 62, 63, 64, 65, 78, 112, 113, 132, 143, 144, 174, 343, 381, 382, 450, 471, 499, 500, 529 - suggestion: Use active voice instead of passive voice
  • Line 96 - suggestion: Spell out 'MOTD' on first use
  • Lines 113, 174, 473 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 123 - suggestion: Spell out 'TSL' on first use
  • Lines 141, 144, 286 - error: Use 'hostname' instead of 'host name'
  • Lines 212, 444 - suggestion: Try to simplify this sentence.
  • Line 233 - error: Use 'filesystem' instead of 'file system'
  • Lines 483, 529 - error: Use 'Controller 1' instead of 'controller a'

content/SCALETutorials/SystemSettings/Advanced/ManageGlobal2FASCALE.md (41 issues)

  • Lines 25, 206 - suggestion: Spell out 'TOTP' on first use
  • Line 25 - suggestion: Spell out 'RFC' on first use
  • Line 37 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 42, 47, 173, 186 - suggestion: Use 'login' instead of 'log in'
  • Lines 42, 47, 173, 186 - error: Use 'login' instead of 'log in'
  • Lines 84, 85, 103, 132, 140, 151, 167, 176, 182, 186 - suggestion: Use active voice instead of passive voice
  • Line 151 - error: Use 'after' instead of 'once'
  • Line 194 - suggestion: Use 'login' instead of 'Log in'
  • Line 194 - error: Use 'login' instead of 'Log in'
  • Line 208 - suggestion: Use Title Case for headings
  • Line 218 - error: Use 'hostname' instead of 'host name'

content/SCALEUIReference/Credentials/UsersScreen.md (35 issues)

  • Lines 13, 26, 139, 144, 149, 185, 203 - suggestion: Use active voice instead of passive voice
  • Lines 90, 94 - suggestion: Keep sentences under 30 words
  • Lines 106, 144, 215 - error: Use 'login' instead of 'log in'
  • Lines 106, 144, 215 - suggestion: Use 'login' instead of 'log in'
  • Line 185 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 191 - error: 'edit' is repeated!

content/SCALETutorials/Credentials/ManageUsers.md (19 issues)

  • Line 56 - suggestion: Spell out 'UID' on first use
  • Lines 66, 96, 129, 136, 152 - suggestion: Use active voice instead of passive voice
  • Line 96 - warning: Use first person (such as 'My') sparingly.
  • Line 152 - suggestion: Use 'login' instead of 'log in'
  • Line 152 - error: Use 'login' instead of 'log in'

content/SCALEUIReference/TopToolbar/Settings/2FAScreenSCALE.md (5 issues)

  • Line 23 - suggestion: Spell out 'URI' on first use
  • Line 32 - suggestion: Use active voice instead of passive voice

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

@linzi-ix linzi-ix merged commit 90958fb into 25.10 Dec 1, 2025
4 checks passed
@linzi-ix linzi-ix deleted the PD-2433-update-2-fa-content-for-behavioral-changes branch December 1, 2025 16:59
@bugclerk
Copy link
Contributor

bugclerk commented Dec 1, 2025

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 Dec 1, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants