Skip to content

Rename user-visible "Custom Profile Attributes" to "User Attributes"#8967

Open
Combs7th wants to merge 1 commit into
v11.7-documentationfrom
claude/issue-8966-20260514-0129
Open

Rename user-visible "Custom Profile Attributes" to "User Attributes"#8967
Combs7th wants to merge 1 commit into
v11.7-documentationfrom
claude/issue-8966-20260514-0129

Conversation

@Combs7th
Copy link
Copy Markdown
Contributor

Summary

Aligns docs prose with mattermost/mattermost#36046 (MM-68235, milestone v11.7.0): user-visible "Custom Profile Attributes" is now "User Attributes".

  • Updated user-facing English in three pages:
    • source/administration-guide/manage/admin/user-attributes.rst
    • source/administration-guide/configure/system-attributes.rst
    • source/administration-guide/manage/mmctl-command-line-tool.rst (descriptions/headings only)
  • Preserved internal identifiers (per PR evidence): mmctl cpa command syntax, API paths, JSON field names, audit event names (createCPAField, deleteCPAField, patchCPAField, patchCPAValues), WebSocket events, and i18n message keys.
  • No changelog / upgrade-notes / legacy-release pages touched.

Closes #8966.

Test plan

  • Sphinx build passes
  • Rendered user-attributes.html, system-attributes.html, and mmctl-command-line-tool.html pages no longer contain "Custom Profile Attribute" or "CPA field" prose
  • Code blocks still show literal mmctl cpa command syntax
  • SME confirms the "Unable to patch User Attribute field" error string is correct

Generated with Claude Code

Aligns docs prose with the mattermost/mattermost#36046 (MM-68235) rename
landing in v11.7.0. Updates user-facing English in three pages while
preserving internal identifiers that the PR confirms were NOT renamed:
the mmctl cpa command syntax, API paths, JSON field names, audit event
names (createCPAField, deleteCPAField, patchCPAField, patchCPAValues),
WebSocket event strings, and i18n message keys.

Refs: #8966

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 14, 2026

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3d8ada0f-cb02-4463-ae20-6ecda201740e

📥 Commits

Reviewing files that changed from the base of the PR and between e7f9e4c and a86a138.

📒 Files selected for processing (3)
  • source/administration-guide/configure/system-attributes.rst
  • source/administration-guide/manage/admin/user-attributes.rst
  • source/administration-guide/manage/mmctl-command-line-tool.rst

📝 Walkthrough

Walkthrough

This PR updates terminology across documentation from "Custom Profile Attributes" to "User Attributes" in three administration guide files: system attributes configuration reference, user attributes management guide, and mmctl command-line tool documentation. All changes are documentation terminology only with no code or API modifications.

Changes

Documentation Terminology Standardization

Layer / File(s) Summary
System attributes documentation reference
source/administration-guide/configure/system-attributes.rst
System attributes section updated to refer to "User attributes" instead of "Custom attributes for user profiles" and corresponding link target.
User attributes administration guide
source/administration-guide/manage/admin/user-attributes.rst
User attributes documentation updated to use consistent "User attributes" terminology in image alt text and API/automation notes, including example error string referring to user attribute field names.
mmctl command-line tool documentation
source/administration-guide/manage/mmctl-command-line-tool.rst
mmctl cpa command documentation updated from "Custom Profile Attribute" to "User Attribute" terminology across command list entry, field section heading, and create/delete/edit/list child-command descriptions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically summarizes the main change: renaming user-visible documentation references from 'Custom Profile Attributes' to 'User Attributes'.
Description check ✅ Passed The description comprehensively explains the documentation updates across three files, the preservation of internal identifiers, and provides a clear test plan aligned with the changeset.
Linked Issues check ✅ Passed The PR fulfills the primary objective: updating documentation references from 'Custom Profile Attributes' to 'User Attributes' across three relevant documentation pages, while preserving internal identifiers as required.
Out of Scope Changes check ✅ Passed All changes are scoped to the stated objective of terminology updates in user-facing documentation. No changelog, upgrade notes, or other restricted documentation pages were modified.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/issue-8966-20260514-0129

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@Combs7th Combs7th changed the base branch from master to v11.7-documentation May 14, 2026 01:36
@Combs7th Combs7th added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor labels May 14, 2026
@Combs7th Combs7th added this to the v11.7.0 milestone May 14, 2026
@Combs7th Combs7th requested a review from jgheithcock May 14, 2026 01:37
@github-actions
Copy link
Copy Markdown
Contributor

Newest code from mattermost has been published to preview environment for Git SHA a86a138

@Combs7th
Copy link
Copy Markdown
Contributor Author

@jgheithcock - Do the above doc updates look accurate to you?

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

Labels

1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update docs references from Custom Profile Attributes to User Attributes

1 participant