Addresses the difficulty users have in configuring networking as part of the setup.

This ticket addresses a significant pain point identified in the UX research's Learning Curve category: Customers and consultants find setting up the migration environment, including configuring networking, is not easy. The task is to improve the usability of the documentation by ensuring this critical setup information is clear, complete, and easy to find.

Key Documentation Tasks

1. Networking Prerequisites:

• Review and significantly enhance the content that explains the required network configuration for MTV to successfully migrate VMs from VMware to OpenShift Virtualization.
• This content should clarify all prerequisites to minimize migration failures related to network setup.

2. Migration Environment Setup:

• Improve the clarity and flow of instructions for the end-to-end migration process setup, as the process is currently perceived as complex.
• Provide essential background or instructional information, particularly addressing the fact that a lack of understanding of automation (e.g., Ansible) could pose a challenge.

To help you move forward with the MTV-3895 documentation overhaul, I’ve drafted a Job-To-Be-Done (JTBD) statement and defined the key personas involved. These tools will help ensure the updated documentation addresses the "Learning Curve" pain points identified in your UX research.

Job-To-Be-Done (JTBD) Statement

The JTBD framework focuses on the motivation and the outcome rather than just the task.

"When I am preparing our infrastructure for a large-scale migration from VMware to OpenShift Virtualization, I want to clearly understand the networking prerequisites and the step-by-step setup logic, so that I can configure the environment correctly the first time and avoid migration failures caused by preventable connectivity or automation gaps."

Target Personas