Skip to content

DOCS-2743 / 26 / MinIO/AIStor trademark legal compliance (26) - #4776

Merged
tonyriv3 merged 2 commits into
26from
DOCS-2743-minio-trademark-26-impl
Sep 3, 2026
Merged

DOCS-2743 / 26 / MinIO/AIStor trademark legal compliance (26)#4776
tonyriv3 merged 2 commits into
26from
DOCS-2743-minio-trademark-26-impl

Conversation

@DjP-iX

@DjP-iX DjP-iX commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Same ticket as master (DOCS-2743, PR #4775) — this is branch 2 of 9. Branch 26 has a much smaller footprint than master: recon confirmed only 2 files mention MinIO here, no casing bugs, and none of master's systemic gaps apply (verified before writing the plan, and independently reconfirmed by the final review):

  • Marks the first mention of MinIO on content/GettingStarted/Migrate/MigratePrep.md with correct capitalization, bold, and the ™ symbol; adds the required attribution sentence to the page's footer.
  • Adds the attribution-only notice to content/Apps/AppsScreens.md (MinIO is named only in a screenshot's alt/id text, never in body prose).
  • Adds a self-contained layouts/shortcodes/trademark-notice.html (this repo has no Hugo Modules and branches don't share code, so this is recreated independently per branch) — fails the build loudly on a bad/missing param, same as master's design.

Unlike master, this branch doesn't need: a Copyrights.md entry (doesn't exist on release branches), a taxonomy-page fix (the marked mention sits well past Hugo's .Summary cutoff), a {{< children >}} fix (neither affected page's frontmatter description mentions MinIO), or any archive-changelog fix (this branch has no content/_archive/ directory).

Test plan

  • hugo --gc --minify builds clean (0 errors)
  • Both affected pages carry the exact attribution sentence once
  • First-mention-only marking verified (the page's second MinIO mention is untouched)
  • Site-wide sweep: no MinIO mark anywhere lacks an adjacent attribution
  • Each task individually reviewed; a dedicated recon pass (checking for master's known gap classes) preceded the plan; final whole-branch review approved in a single round, independently re-verifying each pre-check against live build output

🤖 Generated with Claude Code

@DjP-iX
DjP-iX requested a review from a team as a code owner September 3, 2026 20:11
@bugclerk bugclerk changed the title MinIO/AIStor trademark legal compliance (26) DOCS-2743 / 26 / MinIO/AIStor trademark legal compliance (26) Sep 3, 2026
@bugclerk

bugclerk commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

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

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

Vale Style Guide Issues

📊 Summary: 119 issues found in changed files - 5 errors, 4 warnings, 110 suggestions

Changed files with issues:

content/Apps/AppsScreens.md (61 issues)

  • Line 18 - suggestion: Use Oxford comma before 'and' in lists
  • Line 18 - suggestion: Use the Oxford comma in 'screens, Installed and Discover.'.
  • Lines 19, 27, 93, 152, 370 - suggestion: Keep sentences under 30 words
  • Lines 47, 175 - suggestion: Consider 'TrueNAS' instead of 'Docker'
  • Lines 118, 123 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Lines 122, 125, 144, 145, 152, 166, 183, 211, 252, 260, 275, 293, 314 - suggestion: Use active voice instead of passive voice
  • Lines 146, 147 - suggestion: Use 'signin' instead of 'sign in'
  • Lines 212, 276 - warning: For a general audience, use 'address' rather than 'URL'.
  • Lines 225, 240, 302, 304, 323 - suggestion: Use 'rollback' instead of 'Roll Back'
  • Lines 236, 286, 287, 391, 411 - suggestion: Spell out 'YAML' on first use
  • Line 252 - suggestion: Don't use language (such as 'disabled') that defines people by their disability.
  • Lines 308, 321 - suggestion: Use 'rollback' instead of 'roll back'
  • Lines 313, 317 - suggestion: Use 'rollback' instead of 'Roll back'

content/GettingStarted/Migrate/MigratePrep.md (58 issues)

  • Line 19 - warning: Don't use end punctuation in headings.
  • Lines 26, 32 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 32, 60, 74, 108, 143, 156, 166, 197 - suggestion: Keep sentences under 30 words
  • Line 38 - error: Avoid contractions. Use 'have not' instead of 'haven't'.
  • Lines 43, 194 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 58 - suggestion: Use 'backup' instead of 'back up'
  • Lines 64, 146, 147, 176, 177, 194, 195, 197 - suggestion: Spell out 'UID' on first use
  • Lines 64, 146, 147, 176, 177, 194, 195, 197 - suggestion: Spell out 'GID' on first use
  • Lines 64, 89, 165, 166 - suggestion: Use active voice instead of passive voice
  • Lines 83, 85 - suggestion: Spell out 'CORE' on first use
  • Line 99 - suggestion: Spell out 'LAGG' on first use
  • Line 115 - suggestion: Use 'backup' instead of 'Back up'
  • Line 125 - suggestion: Spell out 'ISO' on first use
  • Line 143 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 163 - suggestion: Use Oxford comma before 'and' in lists

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

@tonyriv3
tonyriv3 merged commit e73e790 into 26 Sep 3, 2026
3 checks passed
@tonyriv3
tonyriv3 deleted the DOCS-2743-minio-trademark-26-impl branch September 3, 2026 20:12
@bugclerk

bugclerk commented Sep 3, 2026

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

Labels

no-time-tracked Technical Writer Review (TR) A technical writer is reviewing the PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants