edits

Author: paigecalvert

docs/vendor/testing-vm-create.md

@@ -164,10 +164,6 @@ For information about how to copy files to a VM after connecting, see [Copy File
 
 ### Compatibility Matrix Forwarder
 
-:::note
-Transferring files using Compatibility Matrix Forwarder is slower than using direct SSH. Compatibility Matrix servers run on EKS, so depending on your location, using the Forwarder adds latency. If you want to transfer large files such as air gap bundles onto the VM, use [Direct SSH](#direct-ssh) in combination with SCP.
-:::
-
 To connect to a VM using the Forwarder:
 
 * SSH into the VM:
@@ -178,6 +174,8 @@ To connect to a VM using the Forwarder:
 
    Where `VMID` is the ID of the VM.
 
+For information about copying files to the VM after connecting, see [After Connecting to the VM with the Forwarder](#after-connecting-to-the-vm-with-the-forwarder) below.
+
 ### Direct SSH
 
 Transferring files using Direct SSH allows you to use your SSH tool of choice, and pass any client-supported flags. Direct SSH requires Replicated CLI v0.104.0 or later.
@@ -334,16 +332,17 @@ To copy files to a VM using the scp endpoint:
 
 ### After Connecting to the VM with the Forwarder
 
-You can also copy files with SCP after connecting to the VM using the Compatibility Matrix Forwarder.
-
 :::note
-**Beta Limitations:** 
+Transferring files using Compatibility Matrix Forwarder is slower than using direct SSH. Compatibility Matrix servers run on EKS, so depending on your location, using the Forwarder adds latency. If you want to transfer large files such as air gap bundles onto the VM, use direct SSH in combination with SCP. See [Using the SCP Endpoint](#using-the-scp-endpoint) above.
+:::
+
+#### Limitations
+Transferring files using the Compatibility Matrix Forwarder has the following limitations:
 - `scp` with flag `-O` (legacy scp protocol) is not supported. 
 - Relative paths is not supported. For example:
   - Unsupported: `scp somefile [email protected]:~`
   - Supported: `scp somefile VMID@replicatedvm:/home/folder/somefile`
 - File permissions are not inherited.
-:::
 
 To copy files to the VM using SCP after connecting with the Compatibility Matrix Forwarder:
 

docs/vendor/testing-vm-networking.md

@@ -16,8 +16,10 @@ You can expose ports on a VM and make them accessible on the public internet. Fo
 replicated vm port expose VMID_OR_VMNAME --port PORT --protocol PROTOCOL
 ```
 
-**Example** – Expose port 3000 with HTTP protocol  
-`replicated vm port expose VM_ID --port 30000 --protocol http`
+For example, to expose port 3000 with HTTP protocol:
+```bash
+replicated vm port expose VM_ID --port 30000 --protocol http
+```
 
 ### List Tunnels
 
@@ -33,59 +35,62 @@ replicated vm port rm VMID_OR_VMNAME
 
 ## Connect a Compatibility Matrix VM with a Compatibility Matrix Cluster
 
-You can make a Compatibility Matrix Cluster available on the same network as a CMX VM.
+You can make a Compatibility Matrix cluster available on the same network as a Compatibility Matrix VM.
 
-**Compatible Clusters:** Openshift, K3s, RKE2, EC, kURL  
-**Requirement:** Replicated CLI 0.90.0 or higher  
-**Note:** Create the cluster first, then attach the new VM to that existing network.
+**Compatible clusters:** Openshift, K3s, RKE2, EC, kURL  
+**Requirement:** Replicated CLI 0.90.0 or later
 
-### Create a Cluster
+To connect a Compatibility Matrix VM with a Compatibility Matrix cluster on the same network:
 
-```bash
-replicated cluster create --distribution K8S_DISTRIBUTION
-```
+1. Create a cluster:
 
-**Example** – `replicated cluster create --distribution k3s`
+    ```bash
+    replicated cluster create --distribution K8S_DISTRIBUTION
+    ```
 
-If successful, you'll see:
+    For example, `replicated cluster create --distribution k3s`.
 
-```
-ID      	NAME			DISTRIBUTION	VERSION	STATUS		CREATED	
-EXPIRES	COST
-b09cf035	affect_mend     	k3s         	1.32.0    	queued      	2025-01-28 16:04 PST    -             $0.60
-```
+    Example output:
 
-### Check the Network
+    ```
+    ID      	NAME			DISTRIBUTION	VERSION	STATUS		CREATED	
+    EXPIRES	COST
+    b09cf035	affect_mend     	k3s         	1.32.0    	queued      	2025-01-28 16:04 PST    -             $0.60
+    ```
 
-```bash
-replicated network ls
-```
+1. Check the network:
 
-If successful, you'll see:
+    ```bash
+    replicated network ls
+    ```
 
-```
-ID		NAME			STATUS		CREATED			EXPIRES
-accbd6a7	affect_mend 	running     	2025-01-28 16:04 PST    	2025-01-28 17:05 PST
-```
+    Example output:
 
-### Create CMX VM on Same Network
+    ```
+    ID		NAME			STATUS		CREATED			EXPIRES
+    accbd6a7	affect_mend 	running     	2025-01-28 16:04 PST    	2025-01-28 17:05 PST
+    ```
 
-```bash
-replicated vm create --distribution DISTRIBUTION --network NETWORK_ID
-```
+1. Create a VM on the same network:
 
-**Example** – `replicated vm create --distribution ubuntu --network accbd6a7`
+    ```bash
+    replicated vm create --distribution DISTRIBUTION --network NETWORK_ID
+    ```
 
-If successful, you'll see:
+    For example, `replicated vm create --distribution ubuntu --network accbd6a7`.
 
-```
-ID      	NAME            DISTRIBUTION	VERSION   	STATUS      	CREATED                 	EXPIRES       	COST
-760a30b1	laughing_tu	ubuntu      	24.04     	queued      	2025-01-28 16:07 PST        -                   $0.60
-```
+    Example output:
+
+    ```
+    ID      	NAME            DISTRIBUTION	VERSION   	STATUS      	CREATED                 	EXPIRES       	COST
+    760a30b1	laughing_tu	ubuntu      	24.04     	queued      	2025-01-28 16:07 PST        -                   $0.60
+    ```
+
+    In this example, both the cluster `b09cf035` and the VM `760a30b1` are now on the same tailnet.
 
-**Example** – Both the cluster `b09cf035` and the VM `760a30b1` are now on the same tailnet.
+## Connect Compatibility Matrix VMs on a Shared Network
 
-## Connect CMX VMs on a Shared Network
+### Create VMs on the Same Network
 
 Use the `--count` flag to create multiple VMs with the same name, all running on the same Network ID.