Skip to content

CNV-94223: Document the custom configuration workflow for creating a VM - #117147

Merged
MirzWeiss merged 1 commit into
openshift:mainfrom
MirzWeiss:CNV-94223
Aug 4, 2026
Merged

CNV-94223: Document the custom configuration workflow for creating a VM#117147
MirzWeiss merged 1 commit into
openshift:mainfrom
MirzWeiss:CNV-94223

Conversation

@MirzWeiss

@MirzWeiss MirzWeiss commented Aug 3, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Version(s):
Main, 4.22, 5.0

Issue: CNV-94223

Link to docs preview

QE review:

  • QE has approved this change.

Claude Code was used to assist with the following tasks for this PR:

  1. Content drafting: Claude drafted the new PROCEDURE module based on the existing draft document I had written previously.
  2. Assembly restructuring: Claude helped consolidate four separate placeholder assembly files with include directives and placeholder comments for future phases.
  3. Full peer review: Claude performed a three-dimension review of the new and modified content:
    • DITA/modular docs compliance: Validated content type metadata, anchor ID format, abstract length, and modular documentation structure.
    • Style review: Checked content against CQA, Red Hat Supplementary Style Guide, and IBM Style Guide requirements.
    • Technical and security review: Reviewed procedure steps for accuracy, correct UI element names, safe examples, and completeness.

Writer judgment applied:

  • Reviewed and validated the procedure steps against the actual web console UI workflow to ensure accuracy of field names, page names, and navigation paths.
  • Made editorial decisions on the structure — consolidating into one assembly rather than keeping four separate stubs — to match the new creation wizard's unified entry point.
  • Verified modular docs compliance (content type metadata, anchor ID format, abstract length).
  • Decided which customization tab details to include vs. omit for appropriate scope at this phase.
  • Reviewed and accepted or adjusted Claude's review findings based on documentation context and product knowledge.

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

openshift-ci-robot commented Aug 3, 2026 •
edited by openshift-ci Bot
Loading

Copy link
Copy Markdown

@MirzWeiss: This pull request references CNV-94223 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):
Main, 4.22, 5.0

Issue: CNV-94223

Link to docs preview:

QE review:

  • QE has approved this change.

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 Aug 3, 2026
@MirzWeiss MirzWeiss added this to the Continuous Release milestone Aug 3, 2026
@ocpdocs-previewbot

ocpdocs-previewbot commented Aug 3, 2026 •
edited
Loading

Copy link
Copy Markdown

🤖 Tue Aug 04 15:28:43 - Prow CI generated the docs preview:

https://117147--ocpdocs-pr.netlify.app/

mayarub
mayarub reviewed Aug 3, 2026
View reviewed changes

@mayarub mayarub left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

What about the flows for the template and clone creation methods?

Comment thread modules/virt-creating-vm-custom-configuration-web.adoc
@MirzWeiss

MirzWeiss commented Aug 3, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

What about the flows for the template and clone creation methods?

These are being tracked in separate JIRA tickets. They should be completed in the next couple of weeks, possibly even sooner.

mayarub
mayarub reviewed Aug 3, 2026
View reviewed changes
Comment thread modules/virt-creating-vm-custom-configuration-web.adoc Outdated
@MirzWeiss @claude
CNV-94223: Document the custom configuration workflow for creating a VM
d8dc963 
In 4.22.2, the wizard moved the name and description fields from the
Review and create page to the Deployment details page. The name field
is now empty by default instead of auto-generated.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Update UI element names to match the current web console: correct radio
button labels, bold labeled UI elements, fix tab ordering, and use
generic description for unlabeled drop-down per Red Hat SSG.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Fix grammar, add verification section, specify RBAC prerequisites,
qualify folder as preview-feature-dependent, improve list formatting,
and re-comment topic map entry until CNV-94227 cleanup is complete.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@openshift-ci

openshift-ci Bot commented Aug 4, 2026

Copy link
Copy Markdown

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

@MirzWeiss
MirzWeiss merged commit eec011c into openshift:main Aug 4, 2026
2 checks passed
@MirzWeiss

MirzWeiss commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

/cherrypick enterprise-4.22
/cherrypick enterprise-5.0

@openshift-cherrypick-robot

openshift-cherrypick-robot commented Aug 4, 2026

Copy link
Copy Markdown

@MirzWeiss: new pull request created: #117221

Details

In response to this:

/cherrypick enterprise-4.22
/cherrypick enterprise-5.0

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 openshift-cherrypick-robot mentioned this pull request Aug 4, 2026
Open
@openshift-cherrypick-robot

openshift-cherrypick-robot commented Aug 4, 2026

Copy link
Copy Markdown

@MirzWeiss: new pull request created: #117222

Details

In response to this:

/cherrypick enterprise-4.22
/cherrypick enterprise-5.0

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 openshift-cherrypick-robot mentioned this pull request Aug 4, 2026
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

2 more reviewers
@mayarub mayarub mayarub approved these changes
@bmaio-redhat bmaio-redhat bmaio-redhat approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

branch/enterprise-4.22 branch/enterprise-5.0 CNV Label for all CNV PRs 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

Milestone

Continuous Release

Development

Successfully merging this pull request may close these issues.

6 participants

@MirzWeiss @openshift-ci-robot @ocpdocs-previewbot @openshift-cherrypick-robot @mayarub @bmaio-redhat