Skip to content

DOCS-2646 / 26 / Docs 2646 update release notes wrt 2 fa changes made on middleware side - #4644

Draft
DjP-iX wants to merge 4 commits into
26from
DOCS-2646-update-release-notes-wrt-2-fa-changes-made-on-middleware-side
Draft

DOCS-2646 / 26 / Docs 2646 update release notes wrt 2 fa changes made on middleware side#4644
DjP-iX wants to merge 4 commits into
26from
DOCS-2646-update-release-notes-wrt-2-fa-changes-made-on-middleware-side

Conversation

@DjP-iX

@DjP-iX DjP-iX commented Jul 1, 2026

Copy link
Copy Markdown
Contributor
  • Add a dedicated Two-Factor Authentication tab to the Upgrading TrueNAS section of VersionNotes.md, explaining the new 30/60-second interval restriction, who is affected (only API-set intervals; UI-configured accounts are safe), what the upgrade does to affected accounts, and how to re-enroll before/after upgrading (including UI and console one-time-password recovery for 2FA-required/STIG systems).
    • Remove the TrueNAS Apps tab to make room (it held no 26-specific upgrade content — just a general "apps are unversioned" note and a marketing banner): relocate the admonition into Preparing to Upgrade and drop the banner.
  • Add a brief Known Issues bullet linking to the new tab.
  • Tighten 2FA interval wording in ManageGlobal2FA.md: remove the "(unless modified)" / "(by default)" hedges, since the UI has no interval control and always uses 30 seconds.

@DjP-iX
DjP-iX requested a review from a team as a code owner July 1, 2026 16:42
@bugclerk bugclerk changed the title Docs 2646 update release notes wrt 2 fa changes made on middleware side DOCS-2646 / 26 / Docs 2646 update release notes wrt 2 fa changes made on middleware side Jul 1, 2026
@bugclerk

bugclerk commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Jul 1, 2026

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

Vale Style Guide Issues

📊 Summary: 200 issues found in changed files - 26 errors, 2 warnings, 172 suggestions

Changed files with issues:

content/GettingStarted/VersionNotes.md (155 issues)

  • Line 39 - suggestion: Try to simplify this sentence.
  • Line 40 - suggestion: '26- ****** Notable Changes' should use sentence-style capitalization.
  • Lines 43, 50, 73, 88, 91, 99, 100, 103, 106, 108, 112, 115, 118, 127, 133, 145, 151, 154, 160, 163, 172, 178, 183, 218, 225, 228, 233, 252, 260, 264, 267, 276, 278, 279, 304, 307, 309, 363, 404, 409, 426, 432, 433, 518 - suggestion: Use active voice instead of passive voice
  • Line 58 - suggestion: Spell out 'FEC' on first use
  • Lines 61, 73, 430, 432, 433 - error: Remove the spaces around ' — '.
  • Lines 64, 384 - error: Form a negative number with an en dash, not a hyphen.
  • Line 64 - suggestion: Spell out 'BETA' on first use
  • Line 76 - error: Avoid possessive forms ('enumeration's'). Rephrase to avoid using apostrophes for possession.
  • Lines 82, 446, 447, 451 - suggestion: Spell out 'SMART' on first use
  • Line 88 - suggestion: Spell out 'OOM' on first use
  • Line 106 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 115 - suggestion: Spell out 'ISO' on first use
  • Line 115 - suggestion: Spell out 'CDROM' on first use
  • Line 118 - error: Use 'Controller 1' instead of 'controller a'
  • Line 148 - warning: For a general audience, use 'address' rather than 'URL'.
  • Lines 165, 281, 408, 409 - error: Use 'login' instead of 'log in'
  • Line 180 - error: Avoid contractions. Use 'what is' instead of 'what's'.
  • Lines 189, 379 - suggestion: Keep sentences under 30 words
  • Line 189 - error: Use 'could' instead of 'May'
  • Line 200 - suggestion: Spell out 'MPIO' on first use
  • Line 207 - suggestion: Spell out 'BRT' on first use
  • Line 210 - error: Avoid possessive forms ('system's'). Rephrase to avoid using apostrophes for possession.
  • Line 240 - suggestion: Spell out 'DRAID' on first use
  • Line 261 - suggestion: Spell out 'CHAP' on first use
  • Line 363 - suggestion: Spell out 'REST' on first use
  • Line 379 - warning: Use first person (such as 'My') sparingly.
  • Lines 384, 386, 388 - suggestion: Spell out 'SCRAM' on first use
  • Line 398 - suggestion: Spell out 'TOTP' on first use
  • Lines 408, 409 - suggestion: Use 'login' instead of 'log in'
  • Line 409 - suggestion: Use 'signin' instead of 'sign in'
  • Line 419 - suggestion: 'Containers and Virtual Machines' should use sentence-style capitalization.
  • Line 439 - suggestion: 'Drive Health Management' should use sentence-style capitalization.
  • Line 443 - suggestion: Spell out 'HDD' on first use
  • Line 457 - suggestion: 'Upgrade Paths' should use sentence-style capitalization.

content/SystemSettings/Advanced/ManageGlobal2FA.md (45 issues)

  • Lines 27, 199 - suggestion: Spell out 'TOTP' on first use
  • Line 27 - suggestion: Spell out 'RFC' on first use
  • Line 39 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 44, 51, 166, 179 - error: Use 'login' instead of 'log in'
  • Lines 44, 51, 166, 179 - suggestion: Use 'login' instead of 'log in'
  • Lines 89, 90, 107, 138, 144, 160, 169, 175, 179, 215 - suggestion: Use active voice instead of passive voice
  • Line 107 - suggestion: Keep sentences under 30 words
  • Line 144 - error: Use 'after' instead of 'once'
  • Line 187 - suggestion: Use 'login' instead of 'Log in'
  • Line 187 - error: Use 'login' instead of 'Log in'
  • Line 201 - suggestion: Use Title Case for headings
  • Line 213 - error: Use 'hostname' instead of 'host name'

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

@github-actions

github-actions Bot commented Jul 2, 2026

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

Vale Style Guide Issues

📊 Summary: 200 issues found in changed files - 26 errors, 2 warnings, 172 suggestions

Changed files with issues:

content/GettingStarted/VersionNotes.md (155 issues)

  • Line 39 - suggestion: Try to simplify this sentence.
  • Line 40 - suggestion: '26- ****** Notable Changes' should use sentence-style capitalization.
  • Lines 43, 50, 73, 88, 91, 99, 100, 103, 106, 108, 112, 115, 118, 127, 133, 145, 151, 154, 160, 163, 172, 178, 183, 218, 225, 228, 233, 252, 260, 264, 267, 276, 278, 279, 304, 307, 309, 363, 404, 409, 426, 432, 433, 518 - suggestion: Use active voice instead of passive voice
  • Line 58 - suggestion: Spell out 'FEC' on first use
  • Lines 61, 73, 430, 432, 433 - error: Remove the spaces around ' — '.
  • Lines 64, 384 - error: Form a negative number with an en dash, not a hyphen.
  • Line 64 - suggestion: Spell out 'BETA' on first use
  • Line 76 - error: Avoid possessive forms ('enumeration's'). Rephrase to avoid using apostrophes for possession.
  • Lines 82, 446, 447, 451 - suggestion: Spell out 'SMART' on first use
  • Line 88 - suggestion: Spell out 'OOM' on first use
  • Line 106 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 115 - suggestion: Spell out 'ISO' on first use
  • Line 115 - suggestion: Spell out 'CDROM' on first use
  • Line 118 - error: Use 'Controller 1' instead of 'controller a'
  • Line 148 - warning: For a general audience, use 'address' rather than 'URL'.
  • Lines 165, 281, 408, 409 - error: Use 'login' instead of 'log in'
  • Line 180 - error: Avoid contractions. Use 'what is' instead of 'what's'.
  • Lines 189, 379 - suggestion: Keep sentences under 30 words
  • Line 189 - error: Use 'could' instead of 'May'
  • Line 200 - suggestion: Spell out 'MPIO' on first use
  • Line 207 - suggestion: Spell out 'BRT' on first use
  • Line 210 - error: Avoid possessive forms ('system's'). Rephrase to avoid using apostrophes for possession.
  • Line 240 - suggestion: Spell out 'DRAID' on first use
  • Line 261 - suggestion: Spell out 'CHAP' on first use
  • Line 363 - suggestion: Spell out 'REST' on first use
  • Line 379 - warning: Use first person (such as 'My') sparingly.
  • Lines 384, 386, 388 - suggestion: Spell out 'SCRAM' on first use
  • Line 398 - suggestion: Spell out 'TOTP' on first use
  • Lines 408, 409 - suggestion: Use 'login' instead of 'log in'
  • Line 409 - suggestion: Use 'signin' instead of 'sign in'
  • Line 419 - suggestion: 'Containers and Virtual Machines' should use sentence-style capitalization.
  • Line 439 - suggestion: 'Drive Health Management' should use sentence-style capitalization.
  • Line 443 - suggestion: Spell out 'HDD' on first use
  • Line 457 - suggestion: 'Upgrade Paths' should use sentence-style capitalization.

content/SystemSettings/Advanced/ManageGlobal2FA.md (45 issues)

  • Lines 27, 199 - suggestion: Spell out 'TOTP' on first use
  • Line 27 - suggestion: Spell out 'RFC' on first use
  • Line 39 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 44, 51, 166, 179 - error: Use 'login' instead of 'log in'
  • Lines 44, 51, 166, 179 - suggestion: Use 'login' instead of 'log in'
  • Lines 89, 90, 107, 138, 144, 160, 169, 175, 179, 215 - suggestion: Use active voice instead of passive voice
  • Line 107 - suggestion: Keep sentences under 30 words
  • Line 144 - error: Use 'after' instead of 'once'
  • Line 187 - suggestion: Use 'login' instead of 'Log in'
  • Line 187 - error: Use 'login' instead of 'Log in'
  • Line 201 - suggestion: Use Title Case for headings
  • Line 213 - error: Use 'hostname' instead of 'host name'

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

micjohnson777
micjohnson777 previously approved these changes Jul 2, 2026
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

Vale Style Guide Issues

📊 Summary: 203 issues found in changed files - 26 errors, 2 warnings, 175 suggestions

Changed files with issues:

content/GettingStarted/VersionNotes.md (158 issues)

  • Line 39 - suggestion: Try to simplify this sentence.
  • Line 40 - suggestion: '26- ****** Notable Changes' should use sentence-style capitalization.
  • Lines 43, 50, 73, 88, 91, 99, 100, 103, 106, 108, 112, 115, 118, 127, 133, 145, 151, 154, 160, 163, 172, 178, 183, 218, 225, 228, 233, 252, 260, 264, 267, 276, 278, 279, 304, 307, 309, 363, 400, 404, 409, 426, 432, 433, 518 - suggestion: Use active voice instead of passive voice
  • Line 58 - suggestion: Spell out 'FEC' on first use
  • Lines 61, 73, 430, 432, 433 - error: Remove the spaces around ' — '.
  • Lines 64, 384 - error: Form a negative number with an en dash, not a hyphen.
  • Line 64 - suggestion: Spell out 'BETA' on first use
  • Line 76 - error: Avoid possessive forms ('enumeration's'). Rephrase to avoid using apostrophes for possession.
  • Lines 82, 446, 447, 451 - suggestion: Spell out 'SMART' on first use
  • Line 88 - suggestion: Spell out 'OOM' on first use
  • Line 106 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 115 - suggestion: Spell out 'ISO' on first use
  • Line 115 - suggestion: Spell out 'CDROM' on first use
  • Line 118 - error: Use 'Controller 1' instead of 'controller a'
  • Line 148 - warning: For a general audience, use 'address' rather than 'URL'.
  • Lines 165, 281, 408, 409 - error: Use 'login' instead of 'log in'
  • Line 180 - error: Avoid contractions. Use 'what is' instead of 'what's'.
  • Lines 189, 379, 400 - suggestion: Keep sentences under 30 words
  • Line 189 - error: Use 'could' instead of 'May'
  • Line 200 - suggestion: Spell out 'MPIO' on first use
  • Line 207 - suggestion: Spell out 'BRT' on first use
  • Line 210 - error: Avoid possessive forms ('system's'). Rephrase to avoid using apostrophes for possession.
  • Line 240 - suggestion: Spell out 'DRAID' on first use
  • Line 261 - suggestion: Spell out 'CHAP' on first use
  • Line 363 - suggestion: Spell out 'REST' on first use
  • Line 379 - warning: Use first person (such as 'My') sparingly.
  • Lines 384, 386, 388 - suggestion: Spell out 'SCRAM' on first use
  • Line 398 - suggestion: Spell out 'TOTP' on first use
  • Lines 408, 409 - suggestion: Use 'login' instead of 'log in'
  • Line 409 - suggestion: Use 'signin' instead of 'sign in'
  • Line 419 - suggestion: 'Containers and Virtual Machines' should use sentence-style capitalization.
  • Line 439 - suggestion: 'Drive Health Management' should use sentence-style capitalization.
  • Line 443 - suggestion: Spell out 'HDD' on first use
  • Line 457 - suggestion: 'Upgrade Paths' should use sentence-style capitalization.

content/SystemSettings/Advanced/ManageGlobal2FA.md (45 issues)

  • Lines 27, 199 - suggestion: Spell out 'TOTP' on first use
  • Line 27 - suggestion: Spell out 'RFC' on first use
  • Line 39 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 44, 51, 166, 179 - suggestion: Use 'login' instead of 'log in'
  • Lines 44, 51, 166, 179 - error: Use 'login' instead of 'log in'
  • Lines 89, 90, 107, 138, 144, 160, 169, 175, 179, 215 - suggestion: Use active voice instead of passive voice
  • Line 107 - suggestion: Keep sentences under 30 words
  • Line 144 - error: Use 'after' instead of 'once'
  • Line 187 - error: Use 'login' instead of 'Log in'
  • Line 187 - suggestion: Use 'login' instead of 'Log in'
  • Line 201 - suggestion: Use Title Case for headings
  • Line 213 - error: Use 'hostname' instead of 'host name'

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

@DjP-iX

DjP-iX commented Jul 2, 2026

Copy link
Copy Markdown
Contributor Author

Marking this one as a draft for now to eventually merge into the 26 RC.1 release notes since it hasn't landed in a released version yet

@DjP-iX
DjP-iX marked this pull request as draft July 2, 2026 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants