Skip to content

PD-2477 / 25.10 / PD-2477-revise-directory-services-and-idmap-docs-for-25-10 #4377

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

Jump to bottom
Open
linzi-ix wants to merge 6 commits into
base: 25.10
Choose a base branch
from
Open

PD-2477 / 25.10 / PD-2477-revise-directory-services-and-idmap-docs-for-25-10 #4377

linzi-ix wants to merge 6 commits into from

Conversation

@linzi-ix
Copy link
Contributor

@linzi-ix linzi-ix commented Dec 31, 2025 •
edited
Loading

Also tackles PD-2476, but I'm keeping it marked as a draft until we get a SME response.

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.

@linzi-ix linzi-ix requested a review from a team as a code owner December 31, 2025 19:17
@bugclerk bugclerk changed the title PD-2477-revise-directory-services-and-idmap-docs-for-25-10 PD-2477 / 25.10 / PD-2477-revise-directory-services-and-idmap-docs-for-25-10 Dec 31, 2025
@bugclerk
Copy link
Contributor

bugclerk commented Dec 31, 2025

Jira URL: https://ixsystems.atlassian.net/browse/PD-2477

@github-actions
Copy link

github-actions bot commented Dec 31, 2025 •
edited
Loading

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 128 issues found in changed files - 11 errors, 2 warnings, 115 suggestions

Changed files with issues:

content/SCALETutorials/Credentials/DirectoryServices/ConfigADSCALE.md (32 issues)

  • Line 23 - suggestion: Spell out 'PAM' on first use
  • Lines 30, 38 - suggestion: Consider 'TrueNAS' instead of 'TrueNAS'
  • Lines 36, 56, 71, 121, 128 - suggestion: Use active voice instead of passive voice
  • Line 36 - error: Use 'Controller 1' instead of 'controller a'
  • Line 48 - suggestion: Spell out 'PDC' on first use
  • Line 48 - suggestion: Spell out 'FSMO' on first use
  • Lines 123, 125, 128, 133, 135, 139 - suggestion: Spell out 'IDMAP' on first use
  • Lines 123, 139 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 128 - suggestion: Spell out 'RID' on first use
  • Line 128 - suggestion: Spell out 'SID' on first use
  • Lines 128, 145, 162 - suggestion: Keep sentences under 30 words

content/SCALETutorials/Credentials/DirectoryServices/ConfigIPASCALE.md (23 issues)

  • Lines 2, 14, 15, 17, 21, 22, 29, 33, 39, 55, 59, 63, 69, 71, 88 - suggestion: Spell out 'IPA' on first use
  • Lines 23, 24, 71 - suggestion: Use active voice instead of passive voice
  • Line 79 - suggestion: Spell out 'SID' on first use
  • Line 90 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/IPA.md (22 issues)

  • Lines 2, 12, 17, 19, 23, 26, 30, 32, 36, 55, 59, 63 - suggestion: Spell out 'IPA' on first use
  • Lines 32, 75 - suggestion: Use active voice instead of passive voice
  • Lines 71, 72 - error: Use 'hostname' instead of 'host name'
  • Line 89 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALEUIReference/Credentials/DirectoryServices/ActiveDirectory.md (19 issues)

  • Lines 35, 106, 111 - suggestion: Spell out 'IDMAP' on first use
  • Lines 37, 87, 100 - suggestion: Use active voice instead of passive voice
  • Line 37 - suggestion: Spell out 'IPA' on first use
  • Lines 100, 118, 119 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 111 - suggestion: Spell out 'RID' on first use
  • Line 111 - suggestion: Spell out 'SID' on first use
  • Lines 119, 120, 121 - error: Don't use 'backend'. See the A-Z word list for details.

content/SCALEUIReference/Credentials/DirectoryServices/LDAP.md (18 issues)

  • Lines 11, 36, 66, 67, 68, 69, 70, 71 - suggestion: Use active voice instead of passive voice
  • Line 36 - suggestion: Spell out 'IPA' on first use
  • Line 85 - warning: For a general audience, use 'address' rather than 'URL'.

content/SCALETutorials/Credentials/DirectoryServices/ConfigLDAPSCALE.md (8 issues)

  • Line 20 - suggestion: Use active voice instead of passive voice
  • Line 20 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 50, 56 - suggestion: Spell out 'MTLS' on first use
  • Line 64 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 72 - suggestion: Spell out 'NSS' on first use
  • Line 107 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/_index.md (5 issues)

  • Line 22 - suggestion: Use active voice instead of passive voice
  • Line 22 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 26, 30 - suggestion: Spell out 'IPA' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigKerberosSCALE.md (1 issues)

  • Line 52 - suggestion: Use Oxford comma before 'and' in lists

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

@linzi-ix linzi-ix marked this pull request as draft January 2, 2026 12:50
@github-actions
Copy link

github-actions bot commented Jan 2, 2026 •
edited
Loading

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 128 issues found in changed files - 11 errors, 2 warnings, 115 suggestions

Changed files with issues:

content/SCALETutorials/Credentials/DirectoryServices/ConfigADSCALE.md (32 issues)

  • Line 25 - suggestion: Spell out 'PAM' on first use
  • Lines 32, 40 - suggestion: Consider 'TrueNAS' instead of 'TrueNAS'
  • Lines 38, 58, 73, 123, 130 - suggestion: Use active voice instead of passive voice
  • Line 38 - error: Use 'Controller 1' instead of 'controller a'
  • Line 50 - suggestion: Spell out 'PDC' on first use
  • Line 50 - suggestion: Spell out 'FSMO' on first use
  • Lines 125, 127, 130, 135, 137, 141 - suggestion: Spell out 'IDMAP' on first use
  • Lines 125, 141 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 130 - suggestion: Spell out 'RID' on first use
  • Line 130 - suggestion: Spell out 'SID' on first use
  • Lines 130, 147, 164 - suggestion: Keep sentences under 30 words

content/SCALETutorials/Credentials/DirectoryServices/ConfigIPASCALE.md (22 issues)

  • Lines 2, 14, 15, 20, 21, 28, 32, 38, 54, 58, 62, 68, 70, 87 - suggestion: Spell out 'IPA' on first use
  • Lines 22, 23, 70 - suggestion: Use active voice instead of passive voice
  • Line 78 - suggestion: Spell out 'SID' on first use
  • Line 89 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/IPA.md (22 issues)

  • Lines 2, 12, 17, 19, 23, 26, 30, 32, 36, 55, 59, 63 - suggestion: Spell out 'IPA' on first use
  • Lines 32, 75 - suggestion: Use active voice instead of passive voice
  • Lines 71, 72 - error: Use 'hostname' instead of 'host name'
  • Line 89 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALEUIReference/Credentials/DirectoryServices/ActiveDirectory.md (19 issues)

  • Lines 35, 106, 111 - suggestion: Spell out 'IDMAP' on first use
  • Lines 37, 87, 100 - suggestion: Use active voice instead of passive voice
  • Line 37 - suggestion: Spell out 'IPA' on first use
  • Lines 100, 118, 119 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 111 - suggestion: Spell out 'RID' on first use
  • Line 111 - suggestion: Spell out 'SID' on first use
  • Lines 119, 120, 121 - error: Don't use 'backend'. See the A-Z word list for details.

content/SCALEUIReference/Credentials/DirectoryServices/LDAP.md (18 issues)

  • Lines 11, 36, 66, 67, 68, 69, 70, 71 - suggestion: Use active voice instead of passive voice
  • Line 36 - suggestion: Spell out 'IPA' on first use
  • Line 85 - warning: For a general audience, use 'address' rather than 'URL'.

content/SCALETutorials/Credentials/DirectoryServices/ConfigLDAPSCALE.md (8 issues)

  • Line 19 - suggestion: Use active voice instead of passive voice
  • Line 19 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 49, 55 - suggestion: Spell out 'MTLS' on first use
  • Line 63 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 71 - suggestion: Spell out 'NSS' on first use
  • Line 106 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/_index.md (5 issues)

  • Line 22 - suggestion: Use active voice instead of passive voice
  • Line 22 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 26, 30 - suggestion: Spell out 'IPA' on first use

static/includes/DirectoryServiceConflictAdmonition.md (1 issues)

  • Line 2 - suggestion: Spell out 'IPA' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigKerberosSCALE.md (1 issues)

  • Line 52 - suggestion: Use Oxford comma before 'and' in lists

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

@anodos325
Copy link
Contributor

anodos325 commented Jan 5, 2026

Did all AD idmap-related documentation get removed? Where are docs explaning RFC2307, AD, etc? (that are still selectable in the AD form)

@github-actions
Copy link

github-actions bot commented Jan 6, 2026 •
edited
Loading

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 162 issues found in changed files - 17 errors, 2 warnings, 143 suggestions

Changed files with issues:

content/SCALETutorials/Credentials/DirectoryServices/ConfigADSCALE.md (60 issues)

  • Line 25 - suggestion: Spell out 'PAM' on first use
  • Lines 32, 40 - suggestion: Consider 'TrueNAS' instead of 'TrueNAS'
  • Lines 38, 58, 73, 115, 117, 123, 130 - suggestion: Use active voice instead of passive voice
  • Line 38 - error: Use 'Controller 1' instead of 'controller a'
  • Line 50 - suggestion: Spell out 'PDC' on first use
  • Line 50 - suggestion: Spell out 'FSMO' on first use
  • Line 117 - error: Use 'could' instead of 'may'
  • Lines 125, 127, 130, 135, 137, 141, 145 - suggestion: Spell out 'IDMAP' on first use
  • Lines 125, 141 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Lines 130, 157, 161 - suggestion: Spell out 'RID' on first use
  • Lines 130, 157 - suggestion: Spell out 'SID' on first use
  • Lines 130, 167, 184 - suggestion: Keep sentences under 30 words
  • Lines 145, 155, 161 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 145 - suggestion: Spell out 'UNIX' on first use
  • Lines 147, 149, 151, 157 - suggestion: Spell out 'UID' on first use
  • Lines 147, 149, 151, 157 - suggestion: Spell out 'GID' on first use
  • Line 147 - suggestion: Spell out 'SFU' on first use
  • Line 153 - suggestion: Spell out 'NSS' on first use
  • Line 159 - suggestion: Spell out 'TDB' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigIPASCALE.md (22 issues)

  • Lines 2, 14, 15, 20, 21, 28, 32, 38, 54, 58, 62, 68, 70, 87 - suggestion: Spell out 'IPA' on first use
  • Lines 22, 23, 70 - suggestion: Use active voice instead of passive voice
  • Line 78 - suggestion: Spell out 'SID' on first use
  • Line 89 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/ActiveDirectory.md (22 issues)

  • Lines 35, 106, 111 - suggestion: Spell out 'IDMAP' on first use
  • Lines 37, 87, 88, 100 - suggestion: Use active voice instead of passive voice
  • Line 37 - suggestion: Spell out 'IPA' on first use
  • Line 88 - error: Use 'could' instead of 'may'
  • Lines 100, 118, 119 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 111 - suggestion: Spell out 'RID' on first use
  • Line 111 - suggestion: Spell out 'SID' on first use
  • Lines 119, 120, 121 - error: Don't use 'backend'. See the A-Z word list for details.

content/SCALEUIReference/Credentials/DirectoryServices/IPA.md (22 issues)

  • Lines 2, 12, 17, 19, 23, 26, 30, 32, 36, 55, 59, 63 - suggestion: Spell out 'IPA' on first use
  • Lines 32, 75 - suggestion: Use active voice instead of passive voice
  • Lines 71, 72 - error: Use 'hostname' instead of 'host name'
  • Line 89 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALEUIReference/Credentials/DirectoryServices/LDAP.md (18 issues)

  • Lines 11, 36, 66, 67, 68, 69, 70, 71 - suggestion: Use active voice instead of passive voice
  • Line 36 - suggestion: Spell out 'IPA' on first use
  • Line 85 - warning: For a general audience, use 'address' rather than 'URL'.

content/SCALETutorials/Credentials/DirectoryServices/ConfigLDAPSCALE.md (8 issues)

  • Line 19 - suggestion: Use active voice instead of passive voice
  • Line 19 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 49, 55 - suggestion: Spell out 'MTLS' on first use
  • Line 63 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 71 - suggestion: Spell out 'NSS' on first use
  • Line 106 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/_index.md (5 issues)

  • Line 22 - suggestion: Use active voice instead of passive voice
  • Line 22 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 26, 30 - suggestion: Spell out 'IPA' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigKerberosSCALE.md (2 issues)

  • Line 51 - suggestion: Use active voice instead of passive voice

content/SCALEUIReference/Credentials/DirectoryServices/KerberosSettings.md (2 issues)

  • Line 28 - suggestion: Use active voice instead of passive voice

static/includes/DirectoryServiceConflictAdmonition.md (1 issues)

  • Line 2 - suggestion: Spell out 'IPA' on first use

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

@linzi-ix
Copy link
Contributor Author

linzi-ix commented Jan 6, 2026

Did all AD idmap-related documentation get removed? Where are docs explaning RFC2307, AD, etc? (that are still selectable in the AD form)

This has now been added back in to the AD articles

@linzi-ix linzi-ix marked this pull request as ready for review January 6, 2026 13:05
@micjohnson777 micjohnson777 added the Technical Writer Review (MJ) A technical writer is reviewing the PR. label Jan 6, 2026
micjohnson777

This comment was marked as resolved.

Sign in to view

linzi-ix and others added 2 commits January 6, 2026 13:36
@linzi-ix @micjohnson777
Update content/SCALETutorials/Credentials/DirectoryServices/ConfigADS…
f8c085c 
…CALE.md

Co-authored-by: MicJ <92740932+micjohnson777@users.noreply.github.com>
@linzi-ix @micjohnson777
Apply suggestions from code review
2719e04 
Co-authored-by: MicJ <92740932+micjohnson777@users.noreply.github.com>
@github-actions
Copy link

github-actions bot commented Jan 6, 2026 •
edited
Loading

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 161 issues found in changed files - 16 errors, 2 warnings, 143 suggestions

Changed files with issues:

content/SCALETutorials/Credentials/DirectoryServices/ConfigADSCALE.md (59 issues)

  • Line 25 - suggestion: Spell out 'PAM' on first use
  • Lines 32, 40 - suggestion: Consider 'TrueNAS' instead of 'TrueNAS'
  • Lines 38, 58, 73, 117, 119, 125, 132 - suggestion: Use active voice instead of passive voice
  • Line 38 - error: Use 'Controller 1' instead of 'controller a'
  • Line 50 - suggestion: Spell out 'PDC' on first use
  • Line 50 - suggestion: Spell out 'FSMO' on first use
  • Lines 127, 129, 132, 137, 139, 143, 147 - suggestion: Spell out 'IDMAP' on first use
  • Lines 127, 143 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Lines 132, 159, 163 - suggestion: Spell out 'RID' on first use
  • Lines 132, 159 - suggestion: Spell out 'SID' on first use
  • Lines 132, 169, 186 - suggestion: Keep sentences under 30 words
  • Lines 147, 157, 163 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 147 - suggestion: Spell out 'UNIX' on first use
  • Lines 149, 151, 153, 159 - suggestion: Spell out 'UID' on first use
  • Lines 149, 151, 153, 159 - suggestion: Spell out 'GID' on first use
  • Line 149 - suggestion: Spell out 'SFU' on first use
  • Line 155 - suggestion: Spell out 'NSS' on first use
  • Line 161 - suggestion: Spell out 'TDB' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigIPASCALE.md (22 issues)

  • Lines 2, 14, 15, 20, 21, 28, 32, 38, 54, 58, 62, 68, 70, 87 - suggestion: Spell out 'IPA' on first use
  • Lines 22, 23, 70 - suggestion: Use active voice instead of passive voice
  • Line 78 - suggestion: Spell out 'SID' on first use
  • Line 89 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/ActiveDirectory.md (22 issues)

  • Lines 35, 106, 111 - suggestion: Spell out 'IDMAP' on first use
  • Lines 37, 87, 88, 100 - suggestion: Use active voice instead of passive voice
  • Line 37 - suggestion: Spell out 'IPA' on first use
  • Line 88 - error: Use 'could' instead of 'may'
  • Lines 100, 118, 119 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 111 - suggestion: Spell out 'RID' on first use
  • Line 111 - suggestion: Spell out 'SID' on first use
  • Lines 119, 120, 121 - error: Don't use 'backend'. See the A-Z word list for details.

content/SCALEUIReference/Credentials/DirectoryServices/IPA.md (22 issues)

  • Lines 2, 12, 17, 19, 23, 26, 30, 32, 36, 55, 59, 63 - suggestion: Spell out 'IPA' on first use
  • Lines 32, 75 - suggestion: Use active voice instead of passive voice
  • Lines 71, 72 - error: Use 'hostname' instead of 'host name'
  • Line 89 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALEUIReference/Credentials/DirectoryServices/LDAP.md (18 issues)

  • Lines 11, 36, 66, 67, 68, 69, 70, 71 - suggestion: Use active voice instead of passive voice
  • Line 36 - suggestion: Spell out 'IPA' on first use
  • Line 85 - warning: For a general audience, use 'address' rather than 'URL'.

content/SCALETutorials/Credentials/DirectoryServices/ConfigLDAPSCALE.md (8 issues)

  • Line 19 - suggestion: Use active voice instead of passive voice
  • Line 19 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 49, 55 - suggestion: Spell out 'MTLS' on first use
  • Line 63 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 71 - suggestion: Spell out 'NSS' on first use
  • Line 106 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/_index.md (5 issues)

  • Line 22 - suggestion: Use active voice instead of passive voice
  • Line 22 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 26, 30 - suggestion: Spell out 'IPA' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigKerberosSCALE.md (2 issues)

  • Line 51 - suggestion: Use active voice instead of passive voice

content/SCALEUIReference/Credentials/DirectoryServices/KerberosSettings.md (2 issues)

  • Line 28 - suggestion: Use active voice instead of passive voice

static/includes/DirectoryServiceConflictAdmonition.md (1 issues)

  • Line 2 - suggestion: Spell out 'IPA' on first use

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

@github-actions
Copy link

github-actions bot commented Jan 6, 2026 •
edited
Loading

Vale Style Guide Issues (Previous - Click to expand)

Vale Style Guide Issues

📊 Summary: 162 issues found in changed files - 17 errors, 2 warnings, 143 suggestions

Changed files with issues:

content/SCALETutorials/Credentials/DirectoryServices/ConfigADSCALE.md (60 issues)

  • Line 25 - suggestion: Spell out 'PAM' on first use
  • Lines 32, 40 - suggestion: Consider 'TrueNAS' instead of 'TrueNAS'
  • Lines 38, 58, 73, 117, 119, 125, 132 - suggestion: Use active voice instead of passive voice
  • Line 38 - error: Use 'Controller 1' instead of 'controller a'
  • Line 50 - suggestion: Spell out 'PDC' on first use
  • Line 50 - suggestion: Spell out 'FSMO' on first use
  • Line 119 - error: Use 'could' instead of 'may'
  • Lines 127, 129, 132, 137, 139, 143, 147 - suggestion: Spell out 'IDMAP' on first use
  • Lines 127, 143 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Lines 132, 159, 163 - suggestion: Spell out 'RID' on first use
  • Lines 132, 159 - suggestion: Spell out 'SID' on first use
  • Lines 132, 169, 186 - suggestion: Keep sentences under 30 words
  • Lines 147, 157, 163 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 147 - suggestion: Spell out 'UNIX' on first use
  • Lines 149, 151, 153, 159 - suggestion: Spell out 'UID' on first use
  • Lines 149, 151, 153, 159 - suggestion: Spell out 'GID' on first use
  • Line 149 - suggestion: Spell out 'SFU' on first use
  • Line 155 - suggestion: Spell out 'NSS' on first use
  • Line 161 - suggestion: Spell out 'TDB' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigIPASCALE.md (22 issues)

  • Lines 2, 14, 15, 20, 21, 28, 32, 38, 54, 58, 62, 68, 70, 87 - suggestion: Spell out 'IPA' on first use
  • Lines 22, 23, 70 - suggestion: Use active voice instead of passive voice
  • Line 78 - suggestion: Spell out 'SID' on first use
  • Line 89 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/ActiveDirectory.md (22 issues)

  • Lines 35, 106, 111 - suggestion: Spell out 'IDMAP' on first use
  • Lines 37, 87, 88, 100 - suggestion: Use active voice instead of passive voice
  • Line 37 - suggestion: Spell out 'IPA' on first use
  • Line 88 - error: Use 'could' instead of 'may'
  • Lines 100, 118, 119 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 111 - suggestion: Spell out 'RID' on first use
  • Line 111 - suggestion: Spell out 'SID' on first use
  • Lines 119, 120, 121 - error: Don't use 'backend'. See the A-Z word list for details.

content/SCALEUIReference/Credentials/DirectoryServices/IPA.md (22 issues)

  • Lines 2, 12, 17, 19, 23, 26, 30, 32, 36, 55, 59, 63 - suggestion: Spell out 'IPA' on first use
  • Lines 32, 75 - suggestion: Use active voice instead of passive voice
  • Lines 71, 72 - error: Use 'hostname' instead of 'host name'
  • Line 89 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALEUIReference/Credentials/DirectoryServices/LDAP.md (18 issues)

  • Lines 11, 36, 66, 67, 68, 69, 70, 71 - suggestion: Use active voice instead of passive voice
  • Line 36 - suggestion: Spell out 'IPA' on first use
  • Line 85 - warning: For a general audience, use 'address' rather than 'URL'.

content/SCALETutorials/Credentials/DirectoryServices/ConfigLDAPSCALE.md (8 issues)

  • Line 19 - suggestion: Use active voice instead of passive voice
  • Line 19 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 49, 55 - suggestion: Spell out 'MTLS' on first use
  • Line 63 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 71 - suggestion: Spell out 'NSS' on first use
  • Line 106 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/_index.md (5 issues)

  • Line 22 - suggestion: Use active voice instead of passive voice
  • Line 22 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 26, 30 - suggestion: Spell out 'IPA' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigKerberosSCALE.md (2 issues)

  • Line 51 - suggestion: Use active voice instead of passive voice

content/SCALEUIReference/Credentials/DirectoryServices/KerberosSettings.md (2 issues)

  • Line 28 - suggestion: Use active voice instead of passive voice

static/includes/DirectoryServiceConflictAdmonition.md (1 issues)

  • Line 2 - suggestion: Spell out 'IPA' on first use

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

@github-actions
Copy link

github-actions bot commented Jan 6, 2026

Vale Style Guide Issues

📊 Summary: 162 issues found in changed files - 16 errors, 2 warnings, 144 suggestions

Changed files with issues:

content/SCALETutorials/Credentials/DirectoryServices/ConfigADSCALE.md (60 issues)

  • Line 25 - suggestion: Spell out 'PAM' on first use
  • Lines 32, 40 - suggestion: Consider 'TrueNAS' instead of 'TrueNAS'
  • Lines 38, 58, 73, 117, 119, 125, 132 - suggestion: Use active voice instead of passive voice
  • Line 38 - error: Use 'Controller 1' instead of 'controller a'
  • Line 50 - suggestion: Spell out 'PDC' on first use
  • Line 50 - suggestion: Spell out 'FSMO' on first use
  • Lines 127, 129, 132, 137, 139, 143, 145, 169 - suggestion: Spell out 'IDMAP' on first use
  • Lines 127, 143 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Lines 132, 181, 185 - suggestion: Spell out 'RID' on first use
  • Lines 132, 181 - suggestion: Spell out 'SID' on first use
  • Lines 132, 151, 188 - suggestion: Keep sentences under 30 words
  • Lines 169, 179, 185 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 169 - suggestion: Spell out 'UNIX' on first use
  • Lines 171, 173, 175, 181 - suggestion: Spell out 'UID' on first use
  • Lines 171, 173, 175, 181 - suggestion: Spell out 'GID' on first use
  • Line 171 - suggestion: Spell out 'SFU' on first use
  • Line 177 - suggestion: Spell out 'NSS' on first use
  • Line 183 - suggestion: Spell out 'TDB' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigIPASCALE.md (22 issues)

  • Lines 2, 14, 15, 20, 21, 28, 32, 38, 54, 58, 62, 68, 70, 87 - suggestion: Spell out 'IPA' on first use
  • Lines 22, 23, 70 - suggestion: Use active voice instead of passive voice
  • Line 78 - suggestion: Spell out 'SID' on first use
  • Line 89 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/ActiveDirectory.md (22 issues)

  • Lines 35, 106, 111 - suggestion: Spell out 'IDMAP' on first use
  • Lines 37, 87, 88, 100 - suggestion: Use active voice instead of passive voice
  • Line 37 - suggestion: Spell out 'IPA' on first use
  • Line 88 - error: Use 'could' instead of 'may'
  • Lines 100, 118, 119 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Line 111 - suggestion: Spell out 'RID' on first use
  • Line 111 - suggestion: Spell out 'SID' on first use
  • Lines 119, 120, 121 - error: Don't use 'backend'. See the A-Z word list for details.

content/SCALEUIReference/Credentials/DirectoryServices/IPA.md (22 issues)

  • Lines 2, 12, 17, 19, 23, 26, 30, 32, 36, 55, 59, 63 - suggestion: Spell out 'IPA' on first use
  • Lines 32, 75 - suggestion: Use active voice instead of passive voice
  • Lines 71, 72 - error: Use 'hostname' instead of 'host name'
  • Line 89 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.

content/SCALEUIReference/Credentials/DirectoryServices/LDAP.md (18 issues)

  • Lines 11, 36, 66, 67, 68, 69, 70, 71 - suggestion: Use active voice instead of passive voice
  • Line 36 - suggestion: Spell out 'IPA' on first use
  • Line 85 - warning: For a general audience, use 'address' rather than 'URL'.

content/SCALETutorials/Credentials/DirectoryServices/ConfigLDAPSCALE.md (8 issues)

  • Line 19 - suggestion: Use active voice instead of passive voice
  • Line 19 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 49, 55 - suggestion: Spell out 'MTLS' on first use
  • Line 63 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 71 - suggestion: Spell out 'NSS' on first use
  • Line 106 - suggestion: Use Title Case for headings

content/SCALEUIReference/Credentials/DirectoryServices/_index.md (5 issues)

  • Line 22 - suggestion: Use active voice instead of passive voice
  • Line 22 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 26, 30 - suggestion: Spell out 'IPA' on first use

content/SCALETutorials/Credentials/DirectoryServices/ConfigKerberosSCALE.md (2 issues)

  • Line 51 - suggestion: Use active voice instead of passive voice

content/SCALEUIReference/Credentials/DirectoryServices/KerberosSettings.md (2 issues)

  • Line 28 - suggestion: Use active voice instead of passive voice

static/includes/DirectoryServiceConflictAdmonition.md (1 issues)

  • Line 2 - suggestion: Spell out 'IPA' on first use

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@anodos325 anodos325 anodos325 left review comments

@micjohnson777 micjohnson777 micjohnson777 requested changes

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

backport-26.04 Re-Review 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.

5 participants

@linzi-ix @bugclerk @anodos325 @micjohnson777