search

redhat-documentation / supplementary-style-guide

This project maintains the Red Hat supplementary style guide for product documentation that supplements the IBM Style guide
https://redhat-documentation.github.io/supplementary-style-guide/
Creative Commons Attribution Share Alike 4.0 International
34 stars 74 forks source link

Guidelines for Organization Administrator / organization administrator and Org Admin / org admin #117

Closed spank50 closed 2 years ago

spank50 commented 3 years ago

In Red Hat customer-facing documentation (solutions, articles, CCS guides) the role of Organization Administrator appears several ways.

Because all the variations refer to the same role, we should use the same term for this role.

Customer Portal Examples: https://access.redhat.com/solutions/17215 https://access.redhat.com/articles/1757953 https://access.redhat.com/articles/customer-service-accounts

Customer Documentation Examples: Satellite https://access.redhat.com/documentation/en-us/red_hat_satellite/5.8/html/getting_started_guide/chap-organizations

User Access/RBAC https://access.redhat.com/documentation/en-us/red_hat_hybrid_cloud_console/2021/html/user_access_configuration_guide_for_role-based_access_control_rbac/assembly-rbac-procedures

IBM Style Guide suggests, "To distinguish whether a noun is a common noun or a proper noun, consider whether the noun refers to any one of many items (common noun) or whether it refers to the specific name of one item (proper noun)."

Because this is the name of a single, specific role that each Red Hat corporate account must have, that suggests the answer is "Organization Administrator / Org Admin".

bergerhoffer commented 2 years ago

PR #118 added this to the style guide. Closing!