Skip to content

DOCS-2648 / 28 / Docs 2648 update permissions content - #4867

Merged
tonyriv3 merged 4 commits into
masterfrom
DOCS-2648-Update-Permissions-Content
Oct 12, 2026
Merged

tonyriv3 merged 4 commits into
masterfrom
DOCS-2648-Update-Permissions-Content

Conversation

@micjohnson777

Copy link
Copy Markdown
Contributor

This PR updates the UI ref and tutorial content related to ACLs and permissions. It adds missing settings, improves descriptions, and adds updated screenshots.

backport to 27

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.

This PR updates the UI ref EditACLScreens.md content with new screenshots and replaces tutorial content with UI Ref descriptions. It adds new sections that better explain the settings in each section by the type of ACL (POSIX, NFSv4).
It updates the ConfiguringACLs.md tutorial with new screenshots and adds missing information on the Set ACL button.
@micjohnson777
micjohnson777 requested a review from a team as a code owner October 9, 2026 17:46
@bugclerk bugclerk changed the title Docs 2648 update permissions content DOCS-2648 / 28 / Docs 2648 update permissions content Oct 9, 2026
@bugclerk

bugclerk commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Oct 9, 2026 •

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

Vale Style Guide Issues

📊 Summary: 61 issues found in changed files - 3 errors, 0 warnings, 58 suggestions

Changed files with issues:

content/SCALE/Datasets/Permissions/ConfiguringACLs.md (36 issues)

  • Lines 48, 55, 57, 78, 85, 107, 158, 171, 212, 215, 229, 287 - suggestion: Keep sentences under 30 words
  • Lines 73, 152, 157, 158, 262, 263, 274 - suggestion: Use active voice instead of passive voice
  • Line 162 - suggestion: Try to simplify this sentence.

content/SCALE/Datasets/Permissions/EditACLScreens.md (25 issues)

  • Line 26 - error: 'edit' is repeated!
  • Line 39 - suggestion: Spell out 'ACS' on first use
  • Lines 41, 98, 115, 123, 132, 161, 162, 204, 242, 244, 245 - suggestion: Use active voice instead of passive voice
  • Line 162 - error: 'r. S' should have one space.
  • Line 162 - suggestion: Use single space after periods and single empty lines between paragraphs
  • Line 171 - suggestion: Spell out 'ACLS' on first use
  • Line 244 - error: Use 'after' instead of 'once'

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

@github-actions

github-actions Bot commented Oct 9, 2026 •

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

Vale Style Guide Issues

📊 Summary: 61 issues found in changed files - 3 errors, 0 warnings, 58 suggestions

Changed files with issues:

content/SCALE/Datasets/Permissions/ConfiguringACLs.md (36 issues)

  • Lines 48, 55, 57, 78, 85, 107, 158, 171, 212, 215, 229, 287 - suggestion: Keep sentences under 30 words
  • Lines 73, 152, 157, 158, 262, 263, 274 - suggestion: Use active voice instead of passive voice
  • Line 162 - suggestion: Try to simplify this sentence.

content/SCALE/Datasets/Permissions/EditACLScreens.md (25 issues)

  • Line 26 - error: 'edit' is repeated!
  • Line 39 - suggestion: Spell out 'ACS' on first use
  • Lines 41, 98, 115, 123, 132, 161, 162, 204, 242, 244, 245 - suggestion: Use active voice instead of passive voice
  • Line 162 - error: 'r. S' should have one space.
  • Line 162 - suggestion: Use single space after periods and single empty lines between paragraphs
  • Line 171 - suggestion: Spell out 'ACLS' on first use
  • Line 244 - error: Use 'after' instead of 'once'

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

@tonyriv3 tonyriv3 added the Technical Writer Review (TR) A technical writer is reviewing the PR. label Oct 12, 2026
@github-actions

Copy link
Copy Markdown

Vale Style Guide Issues

📊 Summary: 61 issues found in changed files - 3 errors, 0 warnings, 58 suggestions

Changed files with issues:

content/SCALE/Datasets/Permissions/ConfiguringACLs.md (36 issues)

  • Lines 48, 55, 57, 78, 85, 107, 158, 171, 212, 215, 229, 287 - suggestion: Keep sentences under 30 words
  • Lines 73, 152, 157, 158, 262, 263, 274 - suggestion: Use active voice instead of passive voice
  • Line 162 - suggestion: Try to simplify this sentence.

content/SCALE/Datasets/Permissions/EditACLScreens.md (25 issues)

  • Line 26 - error: 'edit' is repeated!
  • Line 39 - suggestion: Spell out 'ACS' on first use
  • Lines 41, 98, 115, 123, 132, 161, 162, 204, 242, 244, 245 - suggestion: Use active voice instead of passive voice
  • Line 162 - error: 'r. S' should have one space.
  • Line 162 - suggestion: Use single space after periods and single empty lines between paragraphs
  • Line 171 - suggestion: Spell out 'ACLS' on first use
  • Line 244 - error: Use 'after' instead of 'once'

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

@tonyriv3
tonyriv3 merged commit 12944f9 into master Oct 12, 2026
4 checks passed
@tonyriv3
tonyriv3 deleted the DOCS-2648-Update-Permissions-Content branch October 12, 2026 13:25
@bugclerk

Copy link
Copy Markdown
Contributor

JIRA ticket https://ixsystemsinc.atlassian.net/browse/DOCS-2648 is targeted to the following versions which have not received their corresponding PRs: 25.10, 26

@bugclerk

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants