Skip to content

Conversation

otikhomi
Copy link
Contributor

@otikhomi otikhomi commented Sep 22, 2025

OSDOCS-16195: Removing [discrete] tags from ROSA and OSD

Version(s):
4.19+

Issue:
https://issues.redhat.com/browse/OSDOCS-16195
https://issues.redhat.com/browse/OSDOCS-16194

Link to docs preview:
Previews for 4 assemblies where leveloffsets were modified. Please, check that content is still nested correctly.

  1. OpenID Connect Overview in ROSA Classic (rosa_architecture/rosa-oidc-overview.adoc)
    Published doc VS https://99508--ocpdocs-pr.netlify.app/openshift-rosa/latest/rosa_architecture/rosa-oidc-overview

  2. Install clusters in ROSA HCP:

2.1 ROSA quick start guide (rosa_hcp/rosa-hcp-quickstart-guide.adoc)
Published doc VS https://99508--ocpdocs-pr.netlify.app/openshift-rosa-hcp/latest/rosa_hcp/rosa-hcp-quickstart-guide

2.2 Creating Red Hat OpenShift Service on AWS clusters using the default options (rosa_hcp/rosa-hcp-sts-creating-a-cluster-quickly.adoc)
Published doc VS https://99508--ocpdocs-pr.netlify.app/openshift-rosa-hcp/latest/rosa_hcp/rosa-hcp-sts-creating-a-cluster-quickly

2.3 Creating ROSA with HCP clusters using a custom AWS KMS encryption key (rosa_hcp/rosa-hcp-creating-cluster-with-aws-kms-key.adoc)
Published doc VS https://99508--ocpdocs-pr.netlify.app/openshift-rosa-hcp/latest/rosa_hcp/rosa-hcp-creating-cluster-with-aws-kms-key

QE review:
Not required.

Additional information:
This PR:

  • Removes [discrete] tags from the ROSA and OSD docs (DITA migration requirement)
  • Changes leveoffsets in several assemblies to address build issues. With no discrete tags a sequence of includes gets out of order. Check with the team because changes in leveloffsets might brake assemblies logic (see linked docs previews with affected guides).
  • Reshuffles some of assemblies metadata to make them compliant with the OCP docs requirements: doc_guidelines.adoc#assembly-file-metadata Some changes will also be required for DITA migration.
  • Some changes are my vscode trimming white space at the end of the lines, please, ignore.

@openshift-ci openshift-ci bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Sep 22, 2025
@ocpdocs-previewbot
Copy link

ocpdocs-previewbot commented Sep 22, 2025

🤖 Tue Oct 07 21:59:52 - Prow CI generated the docs preview:
https://99508--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

@otikhomi otikhomi force-pushed the OSDOCS-16195-removing-discrete-tags branch 2 times, most recently from 689c20f to 39fdbd8 Compare October 7, 2025 18:30
Copy link
Contributor

@EricPonvelle EricPonvelle left a comment

Choose a reason for hiding this comment

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

Remove the line breaks around the header content

@otikhomi otikhomi force-pushed the OSDOCS-16195-removing-discrete-tags branch from df7eb4d to 1a6b20b Compare October 7, 2025 21:54
Copy link

openshift-ci bot commented Oct 7, 2025

@otikhomi: all tests passed!

Full PR test history. Your PR dashboard.

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.

@jneczypor jneczypor merged commit a374fa1 into openshift:main Oct 7, 2025
2 checks passed
@jneczypor
Copy link
Contributor

/cherrypick enterprise-4.19
/cherrypick enterprise-4.20

@openshift-cherrypick-robot

@jneczypor: new pull request created: #100168

In response to this:

/cherrypick enterprise-4.19
/cherrypick enterprise-4.20

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.

@openshift-cherrypick-robot

@jneczypor: new pull request created: #100169

In response to this:

/cherrypick enterprise-4.19
/cherrypick enterprise-4.20

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.

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

Labels

branch/enterprise-4.19 branch/enterprise-4.20 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.

5 participants