Skip to content

OSDOCS-16406: Cleaned up CLI References for DITA migration#113938

Open
EricPonvelle wants to merge 1 commit into
openshift:mainfrom
EricPonvelle:OSDOCS-16406_CLI-Tools
Open

OSDOCS-16406: Cleaned up CLI References for DITA migration#113938
EricPonvelle wants to merge 1 commit into
openshift:mainfrom
EricPonvelle:OSDOCS-16406_CLI-Tools

Conversation

@EricPonvelle

Copy link
Copy Markdown
Contributor

Version(s):
enterprise-4.20+ - to meet OCP's coverage of this book as well

Issue:
OSDOCS-16406

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:
This PR updates the CLI references to ensure that DITA compliance is met.

@openshift-ci-robot

openshift-ci-robot commented Jun 23, 2026

Copy link
Copy Markdown

@EricPonvelle: This pull request references OSDOCS-16406 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.0.0" version, but no target version was set.

Details

In response to this:

Version(s):
enterprise-4.20+ - to meet OCP's coverage of this book as well

Issue:
OSDOCS-16406

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:
This PR updates the CLI references to ensure that DITA compliance is met.

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 Jun 23, 2026
[id="rosa-download-ocp-client_{context}"]
== download oc

Download the latest compatible version of the OpenShift Container Platform CLI (`oc`).

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] OpenShiftAsciiDoc.SuggestAttribute: Use the AsciiDoc attribute '{product-title}' rather than the plain text product term 'OpenShift Container Platform', unless your use case is an exception.

|Enables debug mode.
|===

.Examples

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] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

[id="rosa-verify-ocp-client_{context}"]
== verify oc

Verifies that the OpenShift Container Platform CLI (`oc`) is installed correctly.

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] OpenShiftAsciiDoc.SuggestAttribute: Use the AsciiDoc attribute '{product-title}' rather than the plain text product term 'OpenShift Container Platform', unless your use case is an exception.

= Authenticate the {rosa-cli} with a single sign-on authorization code

[role="_abstract"]
The {rosa-cli} allows you to log into your account by using a Red{nbsp}Hat single sign-on authorization code.

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 'log in to' rather than 'log into'. For more information, see RedHat.TermsErrors.


.Optional arguments inherited from parent commands
[cols="30,70"]
|===

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] AsciiDocDITA.TaskStep: Content other than a single list cannot be mapped to DITA steps.


.Optional arguments inherited from parent commands
[cols="30,70"]
|===

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] AsciiDocDITA.TaskStep: Content other than a single list cannot be mapped to DITA steps.

Comment thread modules/rosa-login.adoc

[IMPORTANT]
====
The method of authenticating using Red{nbsp}Hat single sign-on does not break any existing automations that rely on offline tokens. Red{nbsp}Hat recommends using link:https://console.redhat.com/iam/service-accounts[services accounts] for automation purposes. If you still need to use offline tokens for automation or other purposes, you can download the {cluster-manager-url-pull}.

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] AsciiDocDITA.ConceptLink: Move all links and cross references to Additional resources.

Comment thread modules/rosa-logout.adoc

.Optional arguments inherited from parent commands
[cols="30,70"]
|===

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] AsciiDocDITA.TaskStep: Content other than a single list cannot be mapped to DITA steps.

Comment thread modules/rosa-verify.adoc
|Specifies an AWS profile (string) from your credentials file.
|===

.Examples

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] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

Comment thread modules/rosa-verify.adoc
|Specifies an AWS profile (string) from your credentials file.
|===

.Examples

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] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

@openshift-ci

openshift-ci Bot commented Jun 23, 2026

Copy link
Copy Markdown

@EricPonvelle: 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

branch/enterprise-4.20 branch/enterprise-4.21 branch/enterprise-4.22 branch/enterprise-5.0 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