Skip to content

OSDOCS-19532: Expand acronyms at first use in ROSA HCP install book - #119759

Open
jneczypor wants to merge 1 commit into
openshift:mainfrom
jneczypor:OSDOCS-19532
Open

OSDOCS-19532: Expand acronyms at first use in ROSA HCP install book#119759
jneczypor wants to merge 1 commit into
openshift:mainfrom
jneczypor:OSDOCS-19532

Conversation

@jneczypor

Copy link
Copy Markdown
Contributor

What

Adds first-use acronym expansions across the ROSA HCP install book, addressing the CQA acronym findings in OSDOCS-19532.

Acronyms expanded at first prose use: CLI, IAM, VPC, ARN, OIDC, STS, CIDR, KMS, ECR, FIPS.

Notes

  • Uses the {rosa-cli-first}, {oc-first}, and {sts-first} attributes where applicable instead of hardcoded expansions.
  • Only the first prose occurrence per module is expanded; later uses remain the bare acronym.
  • Occurrences inside code blocks, tables, command output, and .Additional resources sections were left unchanged (many were false positives in the ticket's AI-generated lists).
  • Assembly-level hits were verified as false positives (acronyms only appear in included modules or were already expanded).

🤖 Generated with Claude Code

Add first-use expansions for CLI, IAM, VPC, ARN, OIDC, STS, CIDR, KMS,
ECR, and FIPS acronyms across ROSA HCP install modules. Uses the
{rosa-cli-first}, {oc-first}, and {sts-first} attributes where applicable.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Sep 11, 2026
@openshift-ci-robot

openshift-ci-robot commented Sep 11, 2026

Copy link
Copy Markdown

@jneczypor: This pull request references OSDOCS-19532 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "5.1.0" version, but no target version was set.

Details

In response to this:

What

Adds first-use acronym expansions across the ROSA HCP install book, addressing the CQA acronym findings in OSDOCS-19532.

Acronyms expanded at first prose use: CLI, IAM, VPC, ARN, OIDC, STS, CIDR, KMS, ECR, FIPS.

Notes

  • Uses the {rosa-cli-first}, {oc-first}, and {sts-first} attributes where applicable instead of hardcoded expansions.
  • Only the first prose occurrence per module is expanded; later uses remain the bare acronym.
  • Occurrences inside code blocks, tables, command output, and .Additional resources sections were left unchanged (many were false positives in the ticket's AI-generated lists).
  • Assembly-level hits were verified as false positives (acronyms only appear in included modules or were already expanded).

🤖 Generated with Claude Code

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Sep 11, 2026
@ocpdocs-previewbot

Copy link
Copy Markdown

🤖 Fri Sep 11 23:38:42 - Prow CI generated the docs preview:
https://119759--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

`--oidc-config-id=`:: This value is the OIDC configuration ID that you created for your {product-title} cluster.
`--installer-role-arn`:: This value is the installer role ARN that you created when you created the {product-title} account roles.
`--oidc-config-id=`:: This value is the OpenID Connect (OIDC) configuration ID that you created for your {product-title} cluster.
`--installer-role-arn`:: This value is the installer role Amazon Resource Name (ARN) that you created when you created the {product-title} account roles.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] RedHat.TermsErrors: Use 'installation program' rather than 'the installer'. For more information, see RedHat.TermsErrors.

@openshift-ci

openshift-ci Bot commented Sep 11, 2026

Copy link
Copy Markdown

@jneczypor: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

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

Labels

jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants