Skip to content

[OSDOCS-17003] IBM Z callout replacement: replace AsciiDoc callouts with definition …#116250

Open
SNiemann15 wants to merge 2 commits into
openshift:mainfrom
SNiemann15:ibmz_cqa_callout_replacement
Open

[OSDOCS-17003] IBM Z callout replacement: replace AsciiDoc callouts with definition …#116250
SNiemann15 wants to merge 2 commits into
openshift:mainfrom
SNiemann15:ibmz_cqa_callout_replacement

Conversation

@SNiemann15

@SNiemann15 SNiemann15 commented Jul 23, 2026

Copy link
Copy Markdown
Contributor
  • Replaced AsciiDoc callout syntax (<1>, <2>) with definition lists and inline alternatives
  • Added [role="_abstract"] short descriptions to all modules
  • Removed illegal == subsections from ibm-z-configure-devices-mco.adoc
  • Replaced data:text/plain;base64, strings in ibm-z-configure-devices-mco.adoc and ibm-z-secure-execution.adoc to resolve Vault Radar alerts

Modules changed:

  • modules/ibm-z-configure-devices-mco.adoc
  • modules/ibm-z-configure-hw-based-cex-encryption.adoc
  • modules/ibm-z-configure-nbde-with-static-ip.adoc
  • modules/installation-full-ibm-z-kvm-user-infra-machines-iso.adoc
  • modules/installation-ibm-z-kvm-user-infra-machines-iso.adoc
  • modules/installation-ibm-z-user-infra-machines-iso.adoc

Version(s):

Issue: https://redhat.atlassian.net/browse/OSDOCS-17003

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:

…lists and sentences

Replace all <N> AsciiDoc callout markers in IBM Z modules with
DITA-compatible alternatives (definition lists and simple sentences)
to prepare for migration to DITA/AEM.

Modules changed:
- modules/ibm-z-configure-devices-mco.adoc
- modules/ibm-z-configure-hw-based-cex-encryption.adoc
- modules/ibm-z-configure-nbde-with-static-ip.adoc
- modules/installation-full-ibm-z-kvm-user-infra-machines-iso.adoc
- modules/installation-ibm-z-kvm-user-infra-machines-iso.adoc
- modules/installation-ibm-z-user-infra-machines-iso.adoc
@openshift-ci openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jul 23, 2026
files:
- contents:
source: data:text/plain;base64,<encoded_base64_string> <2>
source: <base64_data_uri>

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

In case someone is wondering why I changed this. IBM enforced Vault Radar scans on block secrets last week and I had no chance getting the file updated without changing that string. The commit was entirely rejected.

@openshift-ci

openshift-ci Bot commented Jul 23, 2026

Copy link
Copy Markdown

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

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.

2 participants