Merge pull request #48273 from apinnick/CNV-19778-update-getting-started

CNV-19778: Update links on Getting Started

Author: apinnick

virt/virt-learn-more-about-openshift-virtualization.adoc

@@ -16,35 +16,38 @@ Cluster configuration procedures require `cluster-admin` privileges.
 [id="virt-getting-started-before-you-begin"]
 == Before you begin
 
-* Review the xref:../virt/install/preparing-cluster-for-virt.adoc#preparing-cluster-for-virt[installation requirements].
-* Review the xref:../virt/virtual_machines/virtual_disks/virt-features-for-storage.adoc#virt-features-for-storage[storage features] required for cloning, snapshots, and live migration. See xref:../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Using a CSI-enabled storage provider] for details.
+* Review xref:../virt/install/preparing-cluster-for-virt.adoc#preparing-cluster-for-virt[Preparing your cluster for {VirtProductName}].
+* Review the xref:../virt/virtual_machines/virtual_disks/virt-features-for-storage.adoc#virt-features-for-storage[storage requirements] for cloning, snapshots, and live migration.
 * Install the xref:../virt/install/installing-virt-web.adoc#virt-installing-virt-operator_installing-virt-web[{VirtProductName} Operator].
 * Install the xref:../virt/install/virt-enabling-virtctl.adoc#virt-enabling-virtctl[`virtctl` tool].
 
 [id="virt-getting-started"]
 == Getting started
 
-Create a virtual machine:
+Creating a virtual machine::
+* xref:../virt/virtual_machines/virt-create-vms.adoc#virt-quick-creating-vm_virt-create-vms[Quick create] a virtual machine using a template with an available boot source, for example, {op-system-base-full} or Fedora.
+* xref:../virt/virtual_machines/virt-create-vms.adoc#virt-creating-vm-custom-template_virt-create-vms[Customize a template] to create a virtual machine.
 
-** xref:../virt/virtual_machines/virt-create-vms.adoc#virt-quick-creating-vm_virt-create-vms[Quick create] a virtual machine using the web console.
-** Create and customize link:https://cloud.redhat.com/blog/virtual-machines-as-code-with-openshift-gitops-and-openshift-virtualization[Windows boot sources].
-** Install xref:../virt/virtual_machines/virt-installing-qemu-guest-agent.adoc#virt-installing-virtio-drivers-installing-windows_virt-installing-qemu-guest-agent[VirtIO drivers and the QEMU guest agent] on the virtual machine.
+// Will probably remove this section because we have no procedure for converting Windows ISO to qcow2.
+// * Customize a template to create a Windows virtual machine:
+// ** Download a Windows ISO image, for example, link:https://www.microsoft.com/en-us/evalcenter/download-windows-server-2019[Windows 2019 server].
+//  from the link:https://www.microsoft.com/en-us/evalcenter[Microsoft Evaluation Center].
+// ** Add the image to a xref:../virt/virtual_machines/virt-create-vms.adoc#virt-creating-vm-custom-template_virt-create-vms[Windows template] and create a virtual machine.
+// ** Install xref:../virt/virtual_machines/virt-installing-qemu-guest-agent.adoc#virt-installing-virtio-drivers-installing-windows_virt-installing-qemu-guest-agent[VirtIO drivers and the QEMU guest agent] on the Windows virtual machine.
 
-Connect to a virtual machine:
-
-Connect to a virtual machine::
+Connecting to a virtual machine::
 * Connect to the xref:../virt/virtual_machines/virt-accessing-vm-consoles.adoc#virt-vm-serial-console-web_virt-accessing-vm-consoles[serial console] or xref:../virt/virtual_machines/virt-accessing-vm-consoles.adoc#virt-connecting-vnc-console_virt-accessing-vm-consoles[VNC console] of a virtual machine using the web console.
 * Connect to a virtual machine xref:../virt/virtual_machines/virt-accessing-vm-consoles.adoc#virt-accessing-vmi-ssh_virt-accessing-vm-consoles[using SSH].
 * Connect to a Windows virtual machine xref:../virt/virtual_machines/virt-accessing-vm-consoles.adoc#virt-vm-rdp-console-web_virt-accessing-vm-consoles[using RDP].
 
-Manage a virtual machine::
+Managing a virtual machine::
 * Stop, start, pause, and restart a virtual machine xref:../virt/virtual_machines/virt-controlling-vm-states.adoc#virt-controlling-vm-states[from the web console].
 * Manage a virtual machine, expose a port, and connect to the serial console of a virtual machine  xref:../virt/virt-using-the-cli-tools.adoc#virt-virtctl-commands_virt-using-the-cli-tools[from the command line] with `virtctl`.
 
 [id="virt-getting-started-next-steps"]
 == Next steps
 
-Configure additional networks::
+Configuring additional networks::
 * Linux bridge network:
 ** Create a xref:../virt/virtual_machines/vm_networking/virt-attaching-vm-multiple-networks.adoc#virt-creating-linux-bridge-nncp_virt-attaching-vm-multiple-networks[node network configuration policy]
 ** Create a xref:../virt/virtual_machines/vm_networking/virt-attaching-vm-multiple-networks.adoc#virt-creating-linux-bridge-nad-web_virt-attaching-vm-multiple-networks[network attachment definition].
@@ -54,23 +57,28 @@ Configure additional networks::
 ** Configure an xref:../virt/virtual_machines/vm_networking/virt-configuring-sriov-device-for-vms.adoc#virt-configuring-sriov-device-for-vms[SR-IOV network device].
 ** xref:../virt/virtual_machines/vm_networking/virt-attaching-vm-to-sriov-network.adoc#virt-attaching-vm-to-sriov-network[Attach a virtual machine] to the SR-IOV network.
 
-Monitor your {VirtProductName} environment::
-* Monitor resources, details, status, and top consumers on the  xref:../virt/logging_events_monitoring/virt-reviewing-virtualization-overview.adoc#virt-reviewing-virtualization-overview[*Virtualization Overview* page].
+Monitoring your {VirtProductName} environment::
+* Monitor resources, details, status, and top consumers on the  xref:../virt/logging_events_monitoring/virt-reviewing-virtualization-overview.adoc#virt-reviewing-virtualization-overview[*Overview* page].
 * View high-level information about your virtual machines on the xref:../virt/logging_events_monitoring/virt-viewing-information-about-vm-workloads.adoc#virt-viewing-information-about-vm-workloads[*Virtual Machines* dashboard].
 * View virtual machine xref:../virt/logging_events_monitoring/virt-logs.adoc#virt-logs[logs].
 
-Automate your deployments::
+Automating deployments::
 * xref:../virt/virtual_machines/advanced_vm_management/virt-automating-management-tasks.adoc#virt-automating-virtual-machine-creation-with-ansible_virt-automating-management-tasks[Automate virtual machine deployments] with Ansible.
 * xref:../virt/virtual_machines/virt-automating-windows-sysprep.adoc#virt-automating-windows-sysprep[Automate Windows virtual machine deployments] with `sysprep`.
 
 [id="{context}_additional-resources"]
 [role="_additional-resources"]
 == Additional resources
 
+Before you begin::
+* xref:../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Using a CSI-enabled storage provider]
+* xref:../virt/virtual_machines/virtual_disks/virt-configuring-local-storage-for-vms.adoc#virt-configuring-local-storage-for-vms[Configuring local storage]
 * xref:../networking/k8s_nmstate/k8s-nmstate-about-the-k8s-nmstate-operator.adoc#k8s-nmstate-about-the-k8s-nmstate-operator[About the Kubernetes NMState Operator]
 * xref:../virt/virtual_machines/advanced_vm_management/virt-specifying-nodes-for-vms.adoc#virt-specifying-nodes-for-vms[Specifying nodes for virtual machines]
-* xref:../virt/live_migration/virt-live-migration.adoc#virt-live-migration[Live migration]
+
+Getting started::
 * xref:../virt/vm_templates/virt-creating-vm-template.adoc#virt-creating-vm-template[Virtual machine templates]
-* xref:../virt/virtual_machines/virtual_disks/virt-configuring-local-storage-for-vms.adoc#virt-configuring-local-storage-for-vms[Configuring local storage]
 
+Next steps::
+* xref:../virt/live_migration/virt-live-migration.adoc#virt-live-migration[Live migration]
 * xref:../virt/backup_restore/virt-backup-restore-overview.adoc#virt-backup-restore-overview[Backup and restore]