generic types (#294)

* reorder cloud mentions

* detailed generic machine types

- fixes #267

* Restyle generic types (#295)

Co-authored-by: restyled-io[bot] <32688539+restyled-io[bot]@users.noreply.github.com>

Author: casperdcl

docs/guides/generic-machine-types.md

@@ -0,0 +1,25 @@
+---
+page_title: Generic Machine Types
+subcategory: Development
+---
+
+# Generic Machine Types
+
+The table below is a more detailed version of the common choices summarised in [Task Machine Types](https://registry.terraform.io/providers/iterative/iterative/latest/docs/resources/task#machine-type).
+
+| Type      | [`aws`]       | [`az`]              | [`gcp`]                                         | [`k8s`]                                                |
+| :-------- | :------------ | :------------------ | :---------------------------------------------- | :----------------------------------------------------- |
+| `m`       | `m5.2xlarge`  | `Standard_F8s_v2`   | `e2-custom-8-32768`                             | `cpu: 8`<br>`memory: 32G`                              |
+| `l`       | `m5.8xlarge`  | `Standard_F32s_v2`  | `e2-custom-32-131072`                           | `cpu: 32`<br>`memory: 128G`                            |
+| `xl`      | `m5.16xlarge` | `Standard_F64s_v2`  | `n2-custom-64-262144`                           | `cpu: 64`<br>`memory: 256G`                            |
+| `m+k80`   | `p2.xlarge`   | `Standard_NC6`      | `custom-8-53248`<br>1 `nvidia-tesla-k80`        | `cpu: 4`<br>`memory: 64G`<br>1 `nvidia-tesla-k80`      |
+| `l+k80`   | `p2.8xlarge`  | `Standard_NC12`     | `custom-32-131072`<br>4 `nvidia-tesla-k80`      | `cpu: 32`<br>`memory: 512G`<br>8 `nvidia-tesla-k80`    |
+| `xl+k80`  | `p2.16xlarge` | `Standard_NC24`     | `custom-64-212992-ext`<br>8 `nvidia-tesla-k80`  | `cpu: 64`<br>`memory: 768G`<br>16 × `nvidia-tesla-k80` |
+| `m+v100`  | `p3.xlarge`   | `Standard_NC6s_v3`  | `custom-8-65536-ext`<br>1 `nvidia-tesla-v100`   | `cpu: 8`<br>`memory: 64G`<br>1 `nvidia-tesla-v100`     |
+| `l+v100`  | `p3.8xlarge`  | `Standard_NC12s_v3` | `custom-32-262144-ext`<br>4 `nvidia-tesla-v100` | `cpu: 32`<br>`memory: 256G`<br>4 `nvidia-tesla-v100`   |
+| `xl+v100` | `p3.16xlarge` | `Standard_NC24s_v3` | `custom-64-524288-ext`<br>8 `nvidia-tesla-v100` | `cpu: 64`<br>`memory: 512G`<br>8 `nvidia-tesla-v100`   |
+
+[`aws`]: https://aws.amazon.com/ec2/instance-explorer
+[`az`]: https://azure.microsoft.com/en-us/pricing/vm-selector
+[`gcp`]: https://cloud.google.com/compute/docs/machine-types
+[`k8s`]: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers

docs/index.md

@@ -45,19 +45,19 @@ $ terraform apply
 - `AWS_SECRET_ACCESS_KEY` - Secret access key.
 - `AWS_SESSION_TOKEN` - (Optional) Session token.
 
-### Google Cloud Platform
-
-- `GOOGLE_APPLICATION_CREDENTIALS` - Path to a service account JSON key file.
-
--> **Note:** you can also use `GOOGLE_APPLICATION_CREDENTIALS_DATA` with the **contents** of the service account JSON key file.
-
 ### Microsoft Azure
 
 - `AZURE_CLIENT_ID` - Client identifier.
 - `AZURE_CLIENT_SECRET` - Client secret.
 - `AZURE_SUBSCRIPTION_ID` - Subscription identifier.
 - `AZURE_TENANT_ID` - Tenant identifier.
 
+### Google Cloud Platform
+
+- `GOOGLE_APPLICATION_CREDENTIALS` - Path to a service account JSON key file.
+
+-> **Note:** you can also use `GOOGLE_APPLICATION_CREDENTIALS_DATA` with the **contents** of the service account JSON key file.
+
 ### Kubernetes
 
 - `KUBECONFIG` - Path to a [`kubeconfig` file](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#the-kubeconfig-environment-variable).

docs/resources/task.md

@@ -73,6 +73,8 @@ The Iterative Provider offers some common machine types (medium, large, and extr
 | `l+v100`  |                12 |      224 GB | 2 NVIDIA Tesla V100 |
 | `xl+v100` |                24 |      448 GB | 4 NVIDIA Tesla V100 |
 
+See [Generic Machine Types](https://registry.terraform.io/providers/iterative/iterative/latest/docs/guides/generic-machine-types) for exact specifications for each cloud.
+
 ### Cloud-specific
 
 In addition to generic types, it's possible to specify any machine type supported by the underlying cloud provider.
@@ -81,15 +83,15 @@ In addition to generic types, it's possible to specify any machine type supporte
 
 - `{machine}` - Any [EC2 instance type](https://aws.amazon.com/ec2/instance-explorer) (e.g. `g4dn.xlarge`).
 
+#### Microsoft Azure
+
+- `{machine}` - Any [Azure VM](https://azure.microsoft.com/en-us/pricing/vm-selector) (e.g. `Standard_F8s_v2`).
+
 #### Google Cloud Platform
 
 - `{machine}` - Any [GCP machine type](https://cloud.google.com/compute/docs/machine-types) (e.g. `n2-custom-64-262144`).
 - `{machine}+{accelerator}*{count}` - Any machine and accelerator combination (e.g. `custom-8-53248+nvidia-tesla-k80*1`).
 
-#### Microsoft Azure
-
-- `{machine}` - Any [Azure VM](https://azure.microsoft.com/en-us/pricing/vm-selector) (e.g. `Standard_F8s_v2`).
-
 #### Kubernetes
 
 - `{cpu}-{memory}` - Any [CPU & memory combination](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers) (e.g. `64-256000`).