Skip to content

DOCS-2633 / 27 / DOCS-2633 Update Containers Content (by micjohnson777) - #4894

Merged
DjP-iX merged 4 commits into
27from
DOCS-2633-27
Nov 4, 2026
Merged

DjP-iX merged 4 commits into
27from
DOCS-2633-27

Conversation

@bugclerk

@bugclerk bugclerk commented Nov 4, 2026

Copy link
Copy Markdown
Contributor

Automatic cherry-pick failed. Please resolve conflicts by running:

git reset --hard HEAD~1
git cherry-pick -x b84e038c3dfd778aae9b66df2daf63b8180929fe
git cherry-pick -x fdbc538380cf98d09fa90428568b040f400647e1
git cherry-pick -x c37058b13b1d2e2690e2dcfd4b7befff83c4842a
git cherry-pick -x 4fb6687a5b152f80174c50a61e96effc858d264f
git cherry-pick -x b26c3552cc61f1760bab99b175575a4d3351416b
git cherry-pick -x 1bb50e05da2c2d3842f2fefc858685531ccf4885
git cherry-pick -x 29a2dcc9e682f22621ff2a543495dcf6122eae54
git cherry-pick -x e97cb12fc1d11d4700397a1c1cd3accd0a976fc1
git cherry-pick -x a9b1b5f1486341016f4b2fc9f69813f884bce9f2
git cherry-pick -x 2992808147dc236a298b35ec9c12a0078484b574
git cherry-pick -x 9009c428853685cac3380560de008c669aafea5e
git cherry-pick -x e8021398dc5c299797e4fca109b08e3df45542ae
git cherry-pick -x c9a21c000db57c63b083661b2e2ee7a293647456
git cherry-pick -x 894d207defab2a7064a1b1169a0e449e62d78c1d
git cherry-pick -x e99c9ddcda315ad7a8cc5fdd5cee24e543206f86

If the original PR was merged via a squash, you can just cherry-pick the squashed commit:

git reset --hard HEAD~1
git cherry-pick -x da46b21c9f2749de49f02923d11dbb7d6f3a298a

This PR updates the tutorial and UI ref content for Containers, adding missing UI ref content, updating for release 27 changes, and reorganizes the UI ref article flow (moves section in the document around). It creates a new snippet ContainerStorage.md used in both the tutorial and UI ref article.

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.

Original PR: #4883
Jira URL: https://ixsystemsinc.atlassian.net/browse/DOCS-2633

micjohnson777 and others added 2 commits November 4, 2026 12:02
* DOCS-2633 Update Containers Content

This PR updates the tutorial and UI ref content for Containers, adding missing UI ref content, updating for release 27 changes, and reorganizes the UI ref article flow (moves section in the document around).
It creates a new snippet ContainerStorage.md used in both the tutorial and UI ref article.

* Update content/SCALE/Containers/ManagingContainers.md

Co-authored-by: Dan Pizappi <133042991+DjP-iX@users.noreply.github.com>

* Update content/SCALE/Containers/ManagingContainers.md

Co-authored-by: Dan Pizappi <133042991+DjP-iX@users.noreply.github.com>

* Update content/SCALE/Containers/ContainersScreens.md

Co-authored-by: Dan Pizappi <133042991+DjP-iX@users.noreply.github.com>

* Apply batched suggestions from code review

Co-authored-by: Dan Pizappi <133042991+DjP-iX@users.noreply.github.com>

* DOCS-2633 Recommended Changes

This commit fixes the UI ref settings using Mac from MAC back to Mac, and removes the container migration content

* Apply batched suggestions from code review

Co-authored-by: Qubad786 <mrehanlm93@gmail.com>

* Update ContainersScreens.md

Manual changes to descriptions in line 246 and 141

* Update ManagingContainers.md

Changes to line 478

* Update ContainersScreens.md

Add USB device required info for TrueNAS to show the devices to line 156

* Update ContainersScreens.md

Add **Connect to network** setting option to line 287

* DOCS-2633 Review edits

---------

Co-authored-by: Dan Pizappi <133042991+DjP-iX@users.noreply.github.com>
Co-authored-by: Qubad786 <mrehanlm93@gmail.com>
(cherry picked from commit da46b21)
@github-actions

github-actions Bot commented Nov 4, 2026 •

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

Vale Style Guide Issues

📊 Summary: 220 issues found in changed files - 30 errors, 0 warnings, 190 suggestions

Changed files with issues:

content/Containers/ManagingContainers.md (123 issues)

  • Lines 20, 184, 309, 318, 455, 463, 473, 475, 477 - error: Use 'filesystem' instead of 'file system'
  • Lines 33, 46, 184, 185, 239, 311, 406, 422, 448 - suggestion: Keep sentences under 30 words
  • Lines 55, 118, 166, 193, 200, 233, 236, 269, 282, 291, 297, 304, 309, 324, 330, 388, 389, 390, 414, 445, 446, 448, 488 - suggestion: Use active voice instead of passive voice
  • Lines 64, 185, 187, 194, 199, 206, 210, 228, 229, 239, 241, 243, 299, 300, 324, 327, 389 - suggestion: Spell out 'UID' on first use
  • Lines 64, 187, 228, 229, 299, 389 - suggestion: Spell out 'GID' on first use
  • Line 109 - suggestion: Spell out 'NAT' on first use
  • Line 166 - error: Use 'Controller 1' instead of 'controller a'
  • Lines 188, 229, 300, 323 - error: Remove the spaces around ' — '.
  • Line 194 - error: Don't use 'and so on'. See the A-Z word list for details.
  • Line 288 - suggestion: Spell out 'UTC' on first use
  • Lines 304, 341 - suggestion: Spell out 'ALLOW' on first use
  • Lines 318, 450 - error: Use 'filesystem' instead of 'File System'
  • Line 406 - suggestion: Use Oxford comma before 'and' in lists
  • Line 434 - suggestion: Spell out 'AMD' on first use
  • Line 448 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 453 - error: Use 'filesystem' instead of 'File system'
  • Line 503 - suggestion: Spell out 'NICS' on first use

content/Containers/ContainersScreens.md (89 issues)

  • Lines 32, 65, 383 - suggestion: Spell out 'UID' on first use
  • Lines 32, 65 - suggestion: Spell out 'GID' on first use
  • Lines 59, 60, 86, 90, 92, 151, 158, 179, 180, 227, 245, 253, 280, 284, 299, 304, 305, 348, 360, 365, 369, 374, 379, 400, 411, 413, 420 - suggestion: Use active voice instead of passive voice
  • Lines 90, 153 - suggestion: Keep sentences under 30 words
  • Line 138 - suggestion: Use Oxford comma before 'and' in lists
  • Line 149 - suggestion: 'USB Devices' should use sentence-style capitalization.
  • Lines 189, 194, 201, 202, 211, 400 - error: Use 'filesystem' instead of 'file system'
  • Line 190 - error: Use 'filesystem' instead of 'File system'
  • Line 231 - suggestion: Spell out 'NICS' on first use
  • Line 284 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 369 - error: Use 'after' instead of 'once'
  • Line 425 - error: Use 'Controller 1' instead of 'controller a'

static/includes/ContainerStorage.md (8 issues)

  • Lines 5, 9, 11 - suggestion: Use active voice instead of passive voice
  • Line 5 - error: Use 'filesystem' instead of 'file system'

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

@DjP-iX
DjP-iX marked this pull request as ready for review November 4, 2026 17:06
@DjP-iX
DjP-iX requested a review from a team as a code owner November 4, 2026 17:06
DjP-iX
DjP-iX previously approved these changes Nov 4, 2026
@github-actions

github-actions Bot commented Nov 4, 2026

Copy link
Copy Markdown

Vale Style Guide Issues

📊 Summary: 220 issues found in changed files - 30 errors, 0 warnings, 190 suggestions

Changed files with issues:

content/Containers/ManagingContainers.md (123 issues)

  • Lines 20, 184, 309, 318, 455, 463, 473, 475, 477 - error: Use 'filesystem' instead of 'file system'
  • Lines 33, 46, 184, 185, 239, 311, 406, 422, 448 - suggestion: Keep sentences under 30 words
  • Lines 55, 118, 166, 193, 200, 233, 236, 269, 282, 291, 297, 304, 309, 324, 330, 388, 389, 390, 414, 445, 446, 448, 488 - suggestion: Use active voice instead of passive voice
  • Lines 64, 185, 187, 194, 199, 206, 210, 228, 229, 239, 241, 243, 299, 300, 324, 327, 389 - suggestion: Spell out 'UID' on first use
  • Lines 64, 187, 228, 229, 299, 389 - suggestion: Spell out 'GID' on first use
  • Line 109 - suggestion: Spell out 'NAT' on first use
  • Line 166 - error: Use 'Controller 1' instead of 'controller a'
  • Lines 188, 229, 300, 323 - error: Remove the spaces around ' — '.
  • Line 194 - error: Don't use 'and so on'. See the A-Z word list for details.
  • Line 288 - suggestion: Spell out 'UTC' on first use
  • Lines 304, 341 - suggestion: Spell out 'ALLOW' on first use
  • Lines 318, 450 - error: Use 'filesystem' instead of 'File System'
  • Line 406 - suggestion: Use Oxford comma before 'and' in lists
  • Line 434 - suggestion: Spell out 'AMD' on first use
  • Line 448 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 453 - error: Use 'filesystem' instead of 'File system'
  • Line 503 - suggestion: Spell out 'NICS' on first use

content/Containers/ContainersScreens.md (89 issues)

  • Lines 32, 65, 383 - suggestion: Spell out 'UID' on first use
  • Lines 32, 65 - suggestion: Spell out 'GID' on first use
  • Lines 59, 60, 86, 90, 92, 151, 158, 179, 180, 227, 245, 253, 280, 284, 299, 304, 305, 348, 360, 365, 369, 374, 379, 400, 411, 413, 420 - suggestion: Use active voice instead of passive voice
  • Lines 90, 153 - suggestion: Keep sentences under 30 words
  • Line 138 - suggestion: Use Oxford comma before 'and' in lists
  • Line 149 - suggestion: 'USB Devices' should use sentence-style capitalization.
  • Lines 189, 194, 201, 202, 211, 400 - error: Use 'filesystem' instead of 'file system'
  • Line 190 - error: Use 'filesystem' instead of 'File system'
  • Line 231 - suggestion: Spell out 'NICS' on first use
  • Line 284 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Line 369 - error: Use 'after' instead of 'once'
  • Line 425 - error: Use 'Controller 1' instead of 'controller a'

static/includes/ContainerStorage.md (8 issues)

  • Lines 5, 9, 11 - suggestion: Use active voice instead of passive voice
  • Line 5 - error: Use 'filesystem' instead of 'file system'

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

@DjP-iX
DjP-iX merged commit 7a0c169 into 27 Nov 4, 2026
2 checks passed
@DjP-iX
DjP-iX deleted the DOCS-2633-27 branch November 4, 2026 17:14
@bugclerk

bugclerk commented Nov 4, 2026

Copy link
Copy Markdown
Contributor Author

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

@bugclerk

bugclerk commented Nov 4, 2026

Copy link
Copy Markdown
Contributor Author

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 Nov 4, 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