Rewords Remote Docker specifications and adds table (#9371)

* adds table

* Updates capitalisation

* Updates table syntax

* Update building-docker-images.adoc

Removes whitespace from table

* Update jekyll/_cci2/building-docker-images.adoc

Co-authored-by: Rosie Yohannan <[email protected]>

* Update jekyll/_cci2/building-docker-images.adoc

Co-authored-by: Rosie Yohannan <[email protected]>

* Update jekyll/_cci2/building-docker-images.adoc

Co-authored-by: Rosie Yohannan <[email protected]>

* Update jekyll/_cci2/building-docker-images.adoc

Co-authored-by: Rosie Yohannan <[email protected]>

---------

Co-authored-by: Rosie Yohannan <[email protected]>

Author: alanjclark

jekyll/_cci2/building-docker-images.adoc

@@ -45,25 +45,61 @@ CAUTION: Only use `setup_remote_docker` key for jobs where your primary executor
 [#specifications]
 == Specifications
 
-The resource class used for the remote Docker environment is determined by how you configure the primary container for the job. The sections below show how Docker and remote Docker environments correlate.
-
-For specification, credit, and pricing information for all resource classes, see the link:https://circleci.com/product/features/resource-classes/[Resource class product page].
-
-=== x86
-For *x86* architecture, the equivalent Linux VM resource class is used for remote Docker, relative to how the primary Docker container is configured. For example, if your Docker executor is configured to use a `medium` resource class, the remote Docker environment for that job uses `medium` also. Exceptions to this are as follows:
-
-* If you use the `small` Docker resource class for your primary execution environment, the remote Docker environment uses Linux VM, `medium`.
-* If you use the `medium+` Docker resource class for your primary execution environment, the remote Docker environment uses Linux VM, `large`.
-
-For a full list of available Linux VM resource classes see the xref:configuration-reference#linuxvm-execution-environment[Configuration Reference].
-
-=== Arm
-
-TIP: *Arm on Docker* For pricing information, and a list of CircleCI Docker convenience images that support Arm resource classes, see the link:https://circleci.com/product/features/resource-classes/[Resource classes page].
-
-For *Arm* architecture the equivalent Arm VM resource class is used for remote Docker, relative to how the primary Docker container is configured. For example, if your Docker executor is configured to use a `medium` resource class, the remote Docker environment for that job uses `medium` also.
-
-For a full list of available Arm VM resource classes see the xref:configuration-reference#arm-execution-environment-linux[Configuration Reference].
+CircleCI runs remote Docker environments using **Linux or Arm machine resource classes**, depending on the resource class you assign to the Docker executor.
+
+=== x86 architecture
+
+A remote Docker environment uses a **Linux VM machine** resource class that corresponds to the Docker executor class with the following exceptions:
+
+* `small` maps to `medium` (Linux VM)
+* `medium+` maps to `large` (Linux VM)
+
+=== Arm architecture
+
+Arm-based Docker jobs use an equivalent **Arm machine** resource class for remote Docker.
+
+=== Docker executor to Remote Docker (Linux/Arm Machine) mapping
+
+==== x86 architecture
+
+[.table.table-striped]
+[cols=2*, options="header", stripes=even]
+|===
+| Docker resource class
+| Remote Docker (Linux Machine) resource class
+| `small`
+| `medium` (Linux VM)
+| `medium`
+| `medium` (Linux VM)
+| `medium+`
+| `large` (Linux VM)
+| `large`
+| `large` (Linux VM)
+| `xlarge`
+| `xlarge` (Linux VM)
+| `2xlarge`
+| `2xlarge` (Linux VM)
+|===
+
+==== Arm architecture
+
+[.table.table-striped]
+[cols=2*, options="header", stripes=even]
+|===
+| Docker resource class
+| Remote Docker (Arm Linux Machine) resource class
+| `arm.medium`
+| `arm.medium` (Arm VM)
+| `arm.large` 
+| `arm.large` (Arm VM)  
+| `arm.xlarge`  
+| `arm.xlarge` (Arm VM)
+| `arm.2xlarge`  
+| `arm.2xlarge` (Arm VM)
+|===
+
+- Full list of resource classes: xref:configuration-reference#resourceclass[Configuration Reference].
+- Full specifications and pricing: link:https://circleci.com/pricing/price-list/[CircleCI Pricing]
 
 === CircleCI server
 For CircleCI server installations, contact the systems administrator for specifications.