Improve cluster definition examples in docs

README.md

@@ -55,18 +55,17 @@ module "google-cloud-yavin" {
   }
 
   # Google Cloud
+  cluster_name  = "yavin"
   region        = "us-central1"
   dns_zone      = "example.com"
   dns_zone_name = "example-zone"
-  os_image      = "coreos-stable"
 
-  cluster_name       = "yavin"
-  controller_count   = 1
-  worker_count       = 2
+  # configuration
   ssh_authorized_key = "ssh-rsa AAAAB3Nz..."
-
-  # output assets dir
   asset_dir          = "/home/user/.secrets/clusters/yavin"
+  
+  # optional
+  worker_count = 2
 }
 ```
 

docs/aws.md

@@ -106,19 +106,18 @@ module "aws-tempest" {
     tls = "tls.default"
   }
 
-  cluster_name = "tempest"
-
   # AWS
+  cluster_name = "tempest"
   dns_zone     = "aws.example.com"
   dns_zone_id  = "Z3PAABBCFAKEC0"
-  controller_count   = 1
-  controller_type    = "t2.medium"
-  worker_count       = 2
-  worker_type        = "t2.small"
-  ssh_authorized_key = "ssh-rsa AAAAB3Nz..."
 
-  # bootkube
+  # configuration
+  ssh_authorized_key = "ssh-rsa AAAAB3Nz..."
   asset_dir          = "/home/user/.secrets/clusters/tempest"
+
+  # optional
+  worker_count = 2
+  worker_type  = "t2.medium"
 }
 ```
 

docs/bare-metal.md

@@ -190,11 +190,12 @@ module "bare-metal-mercury" {
   matchbox_http_endpoint  = "http://matchbox.example.com"
   container_linux_channel = "stable"
   container_linux_version = "1632.3.0"
-  ssh_authorized_key      = "ssh-rsa AAAAB3Nz..."
 
-  # cluster
+  # configuration
   cluster_name       = "mercury"
   k8s_domain_name    = "node1.example.com"
+  ssh_authorized_key = "ssh-rsa AAAAB3Nz..."
+  asset_dir          = "/home/user/.secrets/clusters/mercury"
 
   # machines
   controller_names   = ["node1"]
@@ -212,9 +213,6 @@ module "bare-metal-mercury" {
     "node2.example.com",
     "node3.example.com",
   ]
-
-  # output assets dir
-  asset_dir = "/home/user/.secrets/clusters/mercury"
 }
 ```
 

docs/digital-ocean.md

@@ -100,19 +100,18 @@ module "digital-ocean-nemo" {
     tls = "tls.default"
   }
 
+  # Digital Ocean
+  cluster_name = "nemo"
   region       = "nyc3"
   dns_zone     = "digital-ocean.example.com"
 
-  cluster_name     = "nemo"
-  image            = "coreos-stable"
-  controller_count = 1
-  controller_type  = "s-2vcpu-2gb"
+  # configuration
+  ssh_fingerprints = ["d7:9d:79:ae:56:32:73:79:95:88:e3:a2:ab:5d:45:e7"]
+  asset_dir        = "/home/user/.secrets/clusters/nemo"
+  
+  # optional
   worker_count = 2
   worker_type  = "s-1vcpu-1gb"
-  ssh_fingerprints = ["d7:9d:79:ae:56:32:73:79:95:88:e3:a2:ab:5d:45:e7"]
-
-  # output assets dir
-  asset_dir = "/home/user/.secrets/clusters/nemo"
 }
 ```
 

docs/google-cloud.md

@@ -108,18 +108,17 @@ module "google-cloud-yavin" {
   }
 
   # Google Cloud
+  cluster_name  = "yavin"
   region        = "us-central1"
   dns_zone      = "example.com"
   dns_zone_name = "example-zone"
-  os_image      = "coreos-stable"
 
-  cluster_name       = "yavin"
-  controller_count   = 1
-  worker_count       = 2
+  # configuration
   ssh_authorized_key = "ssh-rsa AAAAB3Nz..."
-
-  # output assets dir
   asset_dir          = "/home/user/.secrets/clusters/yavin"
+  
+  # optional
+  worker_count = 2
 }
 ```
 

docs/index.md

@@ -55,18 +55,17 @@ module "google-cloud-yavin" {
   }
 
   # Google Cloud
+  cluster_name  = "yavin"
   region        = "us-central1"
   dns_zone      = "example.com"
   dns_zone_name = "example-zone"
-  os_image      = "coreos-stable"
 
-  cluster_name       = "yavin"
-  controller_count   = 1
-  worker_count       = 2
+  # configuration
   ssh_authorized_key = "ssh-rsa AAAAB3Nz..."
-
-  # output assets dir
   asset_dir          = "/home/user/.secrets/clusters/yavin"
+  
+  # optional
+  worker_count = 2
 }
 ```