[RHACS] [Docs] [rhacs-docs-main] ROX-33164: Fixing DITA errors in cli/command-reference/roxctl-cluster.adoc by agantony · Pull Request #111778 · openshift/openshift-docs

agantony · 2026-05-16T11:46:22Z

Version(s):
4.9+

Issue:
https://redhat.atlassian.net/browse/ROX-33164

Link to docs preview:

SME review: NA

Additional information:

Cherrypick to:
- rhacs-docs-4.10
- rhacs-docs-4.9

openshift-ci-robot · 2026-05-16T11:46:26Z

@agantony: This pull request references ROX-33164 which is a valid jira issue.

Details

In response to this:

Version(s):
4.9+

Issue:
https://redhat.atlassian.net/browse/ROX-33164

Link to docs preview:

SME review: NA

Additional information:

Cherrypick to:

rhacs-docs-4.10

rhacs-docs-4.9

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.

ocpdocs-previewbot · 2026-05-16T11:52:14Z

🤖 Sat May 16 11:52:13 - Prow CI generated the docs preview:
https://111778--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

openshift-ci · 2026-05-16T11:54:21Z

@agantony: 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.

agantony · 2026-05-16T12:18:58Z

PR #111778 Review Guide

Title: [RHACS] [Docs] [rhacs-docs-main] ROX-33164: Fixing DITA errors in cli/command-reference/roxctl-cluster.adoc

Issue: https://redhat.atlassian.net/browse/ROX-33164

PR: #111778

Summary of Changes

This PR fixes DITA compatibility errors in the roxctl cluster CLI reference documentation by extracting inline assembly content and splitting the parent module with inline Usage and Options into separate modules following Red Hat modular documentation standards.

Statistics

Files changed: 9 (6 new, 3 modified)
Lines added: +117
Lines removed: -44
Net change: +73 lines

Changes by File

1. cli/command-reference/roxctl-cluster.adoc (Assembly - Modified)

Type: Assembly restructuring
Changes:

✅ Added assembly abstract with [role="_abstract"]
✅ Removed inline description ("Commands related to a cluster.")
✅ Removed inline Usage section
✅ Removed inline Available commands table
✅ Removed inline Options table
✅ Added 3 assembly-level module includes (overview, usage, available-commands at leveloffset=+1 and +2)
✅ Added 1 assembly-level options include (options at leveloffset=+2)
✅ Added usage/options includes for 1 parent command (delete at leveloffset=+2)

Before (inline content in assembly):

Commands related to a cluster.

.Usage
[source,terminal]
----
$ roxctl cluster [command] [flags]
----

.Available commands
[cols="2,2",options="header"]
|===
|Command |Description
|`delete` |Remove Sensor from Central.
|===

.Options
[cols="2,2",options="header"]
|===
|Option |Description
|`--retry-timeout duration` |Set the retry timeout...
|`-t`, `--timeout duration` |Set the timeout...
|===

//roxctl cluster delete
include::modules/roxctl-cluster-delete.adoc[leveloffset=+1]

After (proper module includes):

[role="_abstract"]
Use the `roxctl cluster` command to manage cluster operations and remove Sensors from Central.
This reference covers the command syntax, available subcommands, and configuration options.

//roxctl cluster overview
include::modules/roxctl-cluster-overview.adoc[leveloffset=+1]

include::modules/roxctl-cluster-usage.adoc[leveloffset=+2]

include::modules/roxctl-cluster-available-commands.adoc[leveloffset=+2]

include::modules/roxctl-cluster-options.adoc[leveloffset=+2]

//Options inherited from the parent command
:commandname: roxctl cluster
include::modules/options-inherited-from-the-parent-command.adoc[leveloffset=+1]
:!commandname:

//roxctl cluster delete
include::modules/roxctl-cluster-delete.adoc[leveloffset=+1]

include::modules/roxctl-cluster-delete-usage.adoc[leveloffset=+2]

include::modules/roxctl-cluster-delete-options.adoc[leveloffset=+2]

2. modules/roxctl-cluster-overview.adoc (New Module - Created)

Type: CONCEPT module (parent)
Purpose: Extracted inline assembly description into parent module

Content:

Module header with assembly reference
:_mod-docs-content-type: CONCEPT
Document ID: [id="roxctl-cluster-overview_{context}"]
Title: = roxctl cluster
Abstract paragraph with [role="_abstract"]
Description: "Commands related to a cluster."

DITA Compliance:

✅ Proper parent module structure (title + abstract only)
✅ Abstract role attribute for DITA short description
✅ Content type attribute
✅ Context-aware document ID

Leveloffset: +1 (renders as H2)

3. modules/roxctl-cluster-usage.adoc (New Module - Created)

Type: REFERENCE module
Purpose: Extracted Usage section from assembly

Content:

Module header with assembly reference
:_mod-docs-content-type: REFERENCE
Document ID: [id="roxctl-cluster-usage_{context}"]
Title: = roxctl cluster usage
Abstract paragraph with [role="_abstract"]
Description: "Usage syntax for the roxctl cluster command."

Usage block:

.Usage
[source,terminal]
----
$ roxctl cluster [command] [flags]
----

DITA Compliance:

✅ REFERENCE content type (usage syntax)
✅ Abstract role attribute
✅ Self-contained usage information

Leveloffset: +2 (renders as H3 under overview)

4. modules/roxctl-cluster-available-commands.adoc (New Module - Created)

Type: REFERENCE module
Purpose: Extracted "Available commands" table from assembly

Content:

Module header with assembly reference
:_mod-docs-content-type: REFERENCE
Document ID: [id="roxctl-cluster-available-commands_{context}"]
Title: = Available commands
Abstract paragraph with [role="_abstract"]
Description: "Available commands for the roxctl cluster command."

Reference table:

[cols="2,2",options="header"]
|===
|Command |Description
|`delete` |Remove Sensor from Central.
|===

DITA Compliance:

✅ REFERENCE content type (reference table)
✅ Abstract role attribute
✅ Self-contained reference data

Leveloffset: +2 (renders as H3 under overview)

5. modules/roxctl-cluster-options.adoc (New Module - Created)

Type: REFERENCE module
Purpose: Extracted "Options" table from assembly

Content:

Module header with assembly reference
:_mod-docs-content-type: REFERENCE
Document ID: [id="roxctl-cluster-options_{context}"]
Title: = Options
Abstract paragraph with [role="_abstract"]
Description: "Options for the roxctl cluster command."

Reference table:

[cols="2,2",options="header"]
|===
|Option |Description
|`--retry-timeout duration` |Set the retry timeout for API requests...
|`-t`, `--timeout duration` |Set the timeout for API requests...
|===

Content improvement: Minor wording fix in --retry-timeout description:

Before: "A value of zero means the full request duration is awaited without retry."
After: "A value of zero allows the full request duration without retry."
Improvement: "allows" is more direct than "means...is awaited"

DITA Compliance:

✅ REFERENCE content type (reference table)
✅ Abstract role attribute
✅ Self-contained reference data

Leveloffset: +2 (renders as H3 under overview)

6. modules/roxctl-cluster-delete.adoc (Parent Module - Modified)

Type: CONCEPT module (changed from REFERENCE)
Changes: Split into parent + usage + options modules

Before (REFERENCE with inline content):

:_mod-docs-content-type: REFERENCE
[id="roxctl-cluster-delete_{context}"]
= roxctl cluster delete

Remove Sensor from Central.

.Usage
[source,terminal]
----
$ roxctl cluster delete [flags]
----

.Options
[cols="2,2",options="header"]
|===
|Option |Description
|`--name string` |Specify the cluster name to delete.
|===

After (CONCEPT with title + abstract only):

:_mod-docs-content-type: CONCEPT
[id="roxctl-cluster-delete_{context}"]
= roxctl cluster delete

[role="_abstract"]
Remove Sensor from Central.

Changes:

✅ Changed content type from REFERENCE → CONCEPT
✅ Removed inline Usage section (extracted to roxctl-cluster-delete-usage.adoc)
✅ Removed inline Options table (extracted to roxctl-cluster-delete-options.adoc)
✅ Added [role="_abstract"] to description
✅ Fixed assembly path reference in header comment

DITA Compliance:

✅ Parent module has only title + abstract
✅ No inline usage or options

7. modules/roxctl-cluster-delete-usage.adoc (New Module - Created)

Type: REFERENCE module
Purpose: Extracted Usage section from roxctl-cluster-delete.adoc

Content:

Module header with assembly reference
:_mod-docs-content-type: REFERENCE
Document ID: [id="roxctl-cluster-delete-usage_{context}"]
Title: = roxctl cluster delete usage
Abstract paragraph with [role="_abstract"]
Description: "Usage syntax for the roxctl cluster delete command."

Usage block:

.Usage
[source,terminal]
----
$ roxctl cluster delete [flags]
----

Leveloffset: +2 (renders as H3 under "roxctl cluster delete")

8. modules/roxctl-cluster-delete-options.adoc (New Module - Created)

Type: REFERENCE module
Purpose: Extracted Options table from roxctl-cluster-delete.adoc

Content:

Module header with assembly reference
:_mod-docs-content-type: REFERENCE
Document ID: [id="roxctl-cluster-delete-options_{context}"]
Title: = Options
Abstract paragraph with [role="_abstract"]
Description: "Options for the roxctl cluster delete command."

Reference table:

[cols="2,2",options="header"]
|===
|Option |Description
|`--name string` |Specify the cluster name to delete.
|===

Leveloffset: +2 (renders as H3 under "roxctl cluster delete")

9. modules/options-inherited-from-the-parent-command.adoc (Shared Module - Modified)

Type: REFERENCE module (shared across multiple assemblies)
Changes: Added missing abstract role attribute

Line 28:

✅ Added: [role="_abstract"] before the introductory paragraph

Before:

= {commandname} command options inherited from the parent command

The `{commandname}` command supports the following options inherited from the parent `roxctl` command:

After:

= {commandname} command options inherited from the parent command

[role="_abstract"]
The `{commandname}` command supports the following options inherited from the parent `roxctl` command:

Rationale: DITA requires the first paragraph after the title to be marked as the abstract/short description.

Structural Changes

Assembly Structure

Before (non-modular):

roxctl cluster (assembly)
├── Inline description (in assembly)
├── Inline Usage (in assembly)
├── Inline Available commands table (in assembly)
├── Inline Options table (in assembly)
├── Options inherited from parent (module, +1)
└── delete (REFERENCE with inline usage/options, +1)

After (fully modular):

roxctl cluster (assembly)
├── roxctl cluster (CONCEPT parent, +1)
│   ├── roxctl cluster usage (REFERENCE, +2)
│   ├── Available commands (REFERENCE, +2)
│   └── Options (REFERENCE, +2)
├── Options inherited from parent (REFERENCE, +1)
└── roxctl cluster delete (CONCEPT, +1)
    ├── roxctl cluster delete usage (REFERENCE, +2)
    └── Options (REFERENCE, +2)

Hierarchy:

H1: Assembly title
H2: "roxctl cluster" overview + "Options inherited" + "roxctl cluster delete"
H3: usage, available commands, options (under each parent)

DITA Compliance Improvements

Issue Type	Location	Fix Applied
Inline assembly content	cli/command-reference/roxctl-cluster.adoc:9-37	Extracted to 4 modules
Missing assembly abstract	cli/command-reference/roxctl-cluster.adoc:9	Added `[role="_abstract"]`
Parent module with inline content	modules/roxctl-cluster-delete.adoc:9-24	Split into 3 modules
Missing abstract role	modules/options-inherited-from-the-parent-command.adoc:28	Added `[role="_abstract"]`

Before:

❌ Inline description, usage, and tables in assembly
❌ Missing assembly abstract
❌ Parent module (delete) with inline usage/options
⚠️ Options module missing abstract role

After:

✅ All content in proper modules
✅ Assembly has descriptive abstract
✅ Parent module (overview) with abstract
✅ Usage modules (REFERENCE) with abstracts
✅ Available commands module (REFERENCE) with abstract
✅ Options modules (REFERENCE) with abstracts
✅ Parent module (delete) with only title + abstract
✅ Shared options module has abstract role

Step-by-Step Review Guide

Step 1: Review the Main Assembly Page

What to check: Assembly structure, module includes, rendering, improved abstract

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html

Review checklist:

Page renders without errors
Assembly abstract displays correctly: "Use the roxctl cluster command to manage cluster operations and remove Sensors from Central. This reference covers the command syntax, available subcommands, and configuration options."
Abstract is more informative than original ("Commands related to a cluster")
TOC shows correct hierarchy:
- roxctl cluster (H2)
  - roxctl cluster usage (H3)
  - Available commands (H3)
  - Options (H3)
- roxctl cluster command options inherited from the parent command (H2)
- roxctl cluster delete (H2)
  - roxctl cluster delete usage (H3)
  - Options (H3)
No duplicate content
No broken includes

Step 2: Verify the Assembly-Level Modules

Overview Module

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#roxctl-cluster-overview_roxctl-cluster

Review checklist:

Section renders as H2
Title displays: "roxctl cluster"
Abstract paragraph displays: "Commands related to a cluster."
Content matches the original inline description from the assembly
Module type is CONCEPT
No inline usage or tables (properly extracted)

Usage Module

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#roxctl-cluster-usage_roxctl-cluster

Review checklist:

Section renders as H3 under "roxctl cluster"
Title displays: "roxctl cluster usage"
Abstract displays: "Usage syntax for the roxctl cluster command."
Usage block displays correctly:
```
$ roxctl cluster [command] [flags]
```
Code block formatting is correct (terminal style)
Module type is REFERENCE

Available Commands Module

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#roxctl-cluster-available-commands_roxctl-cluster

Review checklist:

Section renders as H3 under "roxctl cluster"
Title displays: "Available commands"
Abstract displays: "Available commands for the roxctl cluster command."
Table displays correctly with header row
Table contains 1 row:
- delete: "Remove Sensor from Central."
Table formatting is intact (2 columns, proper alignment)
Module type is REFERENCE

Assembly-Level Options Module

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#roxctl-cluster-options_roxctl-cluster

Review checklist:

Section renders as H3 under "roxctl cluster"
Title displays: "Options"
Abstract displays: "Options for the roxctl cluster command."
Table displays correctly with 2 rows:
- --retry-timeout duration: "Set the retry timeout for API requests. A value of zero allows the full request duration without retry. The default value is 20s."
- -t, --timeout duration: "Set the timeout for API requests representing the maximum duration of a request. The default value is 1m0s."
Check wording improvement: --retry-timeout should say "allows" not "means...is awaited"
Table formatting is intact
Module type is REFERENCE

Step 3: Review the Parent Command Module

roxctl cluster delete

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#roxctl-cluster-delete_roxctl-cluster

Review checklist:

Section renders as H2
Abstract displays: "Remove Sensor from Central."
Usage subsection (H3) displays usage syntax
Options subsection (H3) displays options table
Parent module has NO inline usage/options (properly extracted)

Usage Module:
📄 Preview: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#roxctl-cluster-delete-usage_roxctl-cluster

Renders as H3 under "roxctl cluster delete"
Code block shows: $ roxctl cluster delete [flags]

Options Module:
📄 Preview: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#roxctl-cluster-delete-options_roxctl-cluster

Renders as H3 under "roxctl cluster delete"
Table displays with 1 option: --name string

Step 4: Review the Inherited Options Section

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html#options-inherited-from-the-parent-command_roxctl-cluster

Review checklist:

Section renders as H2
Title displays: "roxctl cluster command options inherited from the parent command"
Abstract paragraph displays with [role="_abstract"] applied
Options table displays correctly
No rendering issues

Step 5: Cross-Check the Assembly Structure

📄 Preview Link: https://111778--ocpdocs-pr.netlify.app/openshift-acs/latest/cli/command-reference/roxctl-cluster.html

Review checklist:

Table of contents shows complete hierarchy:
- roxctl cluster (H2)
  - roxctl cluster usage (H3)
  - Available commands (H3)
  - Options (H3)
- roxctl cluster command options inherited from the parent command (H2)
- roxctl cluster delete (H2)
  - roxctl cluster delete usage (H3)
  - Options (H3)
All sections are clickable in TOC
Anchors work correctly (try clicking TOC links)
No duplicate IDs or anchor conflicts
Reading flow is logical and natural

Step 6: Validate DITA Compliance (Technical Review)

Files to validate:

cli/command-reference/roxctl-cluster.adoc
modules/roxctl-cluster-overview.adoc
modules/roxctl-cluster-usage.adoc
modules/roxctl-cluster-available-commands.adoc
modules/roxctl-cluster-options.adoc
modules/roxctl-cluster-delete.adoc
modules/roxctl-cluster-delete-usage.adoc
modules/roxctl-cluster-delete-options.adoc
modules/options-inherited-from-the-parent-command.adoc

Validation steps:

Run Vale with AsciiDocDITA rules
Check for:
- No inline assembly content (all content in modules)
- Assembly has [role="_abstract"]
- All parent modules have only title + abstract (CONCEPT type)
- All modules have [role="_abstract"] on first paragraph
- All modules have :_mod-docs-content-type: attribute
- Leveloffset hierarchy is correct (+1, +2)
- No unsupported DITA elements

Expected Rendering Behavior

Before (Non-DITA-Compliant)

Inline description, usage, available commands, and options in assembly
Missing assembly abstract
1 parent module (REFERENCE) with inline usage/options
Missing abstract role on shared module

After (DITA-Compliant)

✅ Assembly has descriptive abstract
✅ All content in proper modules
✅ 4 assembly-level modules (overview, usage, available commands, options)
✅ 1 parent module (CONCEPT) with title + abstract only
✅ 2 sub-modules (usage, options) for delete command
✅ Shared module has abstract role
✅ Proper hierarchy (H2 → H3)
✅ Minor wording improvement in --retry-timeout description
✅ No visual changes to rendered output (same hierarchy, same content)

Review Priority Checklist

High Priority (Must Review)

Assembly page renders correctly with no broken includes
Assembly abstract is descriptive and accurate
4 assembly-level modules display correctly
Parent module (delete) converted from REFERENCE → CONCEPT
2 new usage/options modules render correctly
Hierarchy is correct (H2 → H3)
No duplicate or missing content

Medium Priority (Should Review)

Usage modules display syntax correctly
Options modules display tables correctly
Abstract role attributes are present
Wording improvement in --retry-timeout description

Low Priority (Nice to Review)

TOC navigation works smoothly
Anchor links function correctly
Code blocks use correct formatting

Approval Checklist

Before approving this PR, confirm:

Testing & Validation

Build Test

./scripts/prow-smoke-test.sh -a openshift-acs "Red Hat Advanced Cluster Security" "4.10"

DITA Validation

vale --config=.vale.ini cli/command-reference/roxctl-cluster.adoc modules/roxctl-cluster-*.adoc

Expected result: No AsciiDocDITA errors

Visual Inspection

Open assembly in browser preview
Verify TOC hierarchy (2 levels: H2 → H3)
Check all 7 sections render correctly
Verify tables display properly
Test anchor navigation

Questions for Reviewers

Assembly abstract: Is the new abstract clear and helpful?
Module naming: Are the module names descriptive?
Wording improvement: Does the improved --retry-timeout description read better?
Content organization: Does the modular structure improve navigation?
DITA compliance: Does the structure meet all DITA conversion requirements?

Additional Context

Jira Issue: ROX-33164
Versions: 4.9+
Cherrypick to: rhacs-docs-4.10, rhacs-docs-4.9

This PR is part of a larger DITA rework initiative following the pattern from PRs #111737, #111774-111777. The changes follow the Red Hat modular documentation pattern:

Assembly: Orchestrates modules with include directives, has descriptive abstract
Parent modules: Title + abstract only (CONCEPT)
Usage/Options modules: Included at leveloffset=+2 under parent (REFERENCE)

Impact: This change also improves the shared options-inherited-from-the-parent-command.adoc module.

File Summary

File	Type	Change	Lines
cli/command-reference/roxctl-cluster.adoc	Assembly	Modified	+13/-26
modules/roxctl-cluster-overview.adoc	CONCEPT	New	+10/0
modules/roxctl-cluster-usage.adoc	REFERENCE	New	+16/0
modules/roxctl-cluster-available-commands.adoc	REFERENCE	New	+18/0
modules/roxctl-cluster-options.adoc	REFERENCE	New	+21/0
modules/roxctl-cluster-delete.adoc	CONCEPT	Modified	+4/-18
modules/roxctl-cluster-delete-usage.adoc	REFERENCE	New	+16/0
modules/roxctl-cluster-delete-options.adoc	REFERENCE	New	+18/0
modules/options-inherited-from-the-parent-command.adoc	REFERENCE (shared)	Modified	+1/0

Total: 9 files (6 new, 3 modified), +117/-44 lines

Generated with AI Code Tools

ROX33164 Fixing DITA errors in cli/command-reference/roxctl-cluster.adoc

acfd7b5

openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label May 16, 2026

agantony added RHACS Label for RHACS related PRs that go in the rhacs-docs branch rhacs-docs-4.9 rhacs-docs-4.10 labels May 16, 2026

openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label May 16, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[RHACS] [Docs] [rhacs-docs-main] ROX-33164: Fixing DITA errors in cli/command-reference/roxctl-cluster.adoc#111778

[RHACS] [Docs] [rhacs-docs-main] ROX-33164: Fixing DITA errors in cli/command-reference/roxctl-cluster.adoc#111778
agantony wants to merge 1 commit into
openshift:rhacs-docs-mainfrom
agantony:ROX33164-dita-rework-installing-roxctl-cluster

agantony commented May 16, 2026

Uh oh!

openshift-ci-robot commented May 16, 2026 •

edited by openshift-ci Bot

Loading

Uh oh!

ocpdocs-previewbot commented May 16, 2026

Uh oh!

openshift-ci Bot commented May 16, 2026

Uh oh!

agantony commented May 16, 2026 •

edited by openshift-ci Bot

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

agantony commented May 16, 2026

Uh oh!

openshift-ci-robot commented May 16, 2026 • edited by openshift-ci Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-previewbot commented May 16, 2026

Uh oh!

openshift-ci Bot commented May 16, 2026

Uh oh!

agantony commented May 16, 2026 • edited by openshift-ci Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR #111778 Review Guide

Summary of Changes

Statistics

Changes by File

1. cli/command-reference/roxctl-cluster.adoc (Assembly - Modified)

2. modules/roxctl-cluster-overview.adoc (New Module - Created)

3. modules/roxctl-cluster-usage.adoc (New Module - Created)

4. modules/roxctl-cluster-available-commands.adoc (New Module - Created)

5. modules/roxctl-cluster-options.adoc (New Module - Created)

6. modules/roxctl-cluster-delete.adoc (Parent Module - Modified)

7. modules/roxctl-cluster-delete-usage.adoc (New Module - Created)

8. modules/roxctl-cluster-delete-options.adoc (New Module - Created)

9. modules/options-inherited-from-the-parent-command.adoc (Shared Module - Modified)

Structural Changes

Assembly Structure

DITA Compliance Improvements

Step-by-Step Review Guide

Step 1: Review the Main Assembly Page

Step 2: Verify the Assembly-Level Modules

Overview Module

Usage Module

Available Commands Module

Assembly-Level Options Module

Step 3: Review the Parent Command Module

roxctl cluster delete

Step 4: Review the Inherited Options Section

Step 5: Cross-Check the Assembly Structure

Step 6: Validate DITA Compliance (Technical Review)

Expected Rendering Behavior

Before (Non-DITA-Compliant)

After (DITA-Compliant)

Review Priority Checklist

High Priority (Must Review)

Medium Priority (Should Review)

Low Priority (Nice to Review)

Approval Checklist

Testing & Validation

Build Test

DITA Validation

Visual Inspection

Questions for Reviewers

Additional Context

File Summary

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

openshift-ci-robot commented May 16, 2026 •

edited by openshift-ci Bot

Loading

agantony commented May 16, 2026 •

edited by openshift-ci Bot

Loading