diff --git a/docs/cli/kops.md b/docs/cli/kops.md
index c5472f4e4e..9db9fd81a8 100644
--- a/docs/cli/kops.md
+++ b/docs/cli/kops.md
@@ -24,20 +24,20 @@ It allows you to create, destroy, upgrade and maintain clusters.
 ```
 
 ### SEE ALSO
-* [kops completion](kops_completion.md)	 - Output shell completion code for the given shell (bash)
-* [kops create](kops_create.md)	 - Create a resource by filename or stdin
-* [kops delete](kops_delete.md)	 - delete clusters
-* [kops describe](kops_describe.md)	 - describe objects
-* [kops edit](kops_edit.md)	 - Edit resource
-* [kops export](kops_export.md)	 - export clusters/kubecfg
-* [kops get](kops_get.md)	 - list or get objects
-* [kops import](kops_import.md)	 - import clusters
-* [kops replace](kops_replace.md)	 - Replace a resource by filename or stdin
-* [kops rolling-update](kops_rolling-update.md)	 - rolling update clusters
-* [kops secrets](kops_secrets.md)	 - Manage secrets & keys
-* [kops toolbox](kops_toolbox.md)	 - Misc infrequently used commands
-* [kops update](kops_update.md)	 - update clusters
-* [kops upgrade](kops_upgrade.md)	 - upgrade clusters
-* [kops validate](kops_validate.md)	 - Validate Cluster
-* [kops version](kops_version.md)	 - Print the client version information
+* [kops completion](kops_completion.md)	 - Output shell completion code for the given shell (bash or zsh).
+* [kops create](kops_create.md)	 - Create a resource by filename or stdin.
+* [kops delete](kops_delete.md)	 - Delete clusters and instancegroups
+* [kops describe](kops_describe.md)	 - Get additional information about cloud resources.
+* [kops edit](kops_edit.md)	 - Edit clusters and other resrouces.
+* [kops export](kops_export.md)	 - Exports a kubecfg for target cluster.
+* [kops get](kops_get.md)	 - List all instances of a resource.
+* [kops import](kops_import.md)	 - Import existing resources into the state store.
+* [kops replace](kops_replace.md)	 - Replace a resource by filename or stdin.
+* [kops rolling-update](kops_rolling-update.md)	 - Initiate rolling updates on clusters.
+* [kops secrets](kops_secrets.md)	 - Manage secrets & keys.
+* [kops toolbox](kops_toolbox.md)	 - Misc infrequently used commands.
+* [kops update](kops_update.md)	 - Creates or updates cloud resources to match cluster spec.
+* [kops upgrade](kops_upgrade.md)	 - Automates checking for and applying Kubernetes updates.
+* [kops validate](kops_validate.md)	 - Run validation check on Kubernetes cluster.
+* [kops version](kops_version.md)	 - Print the client version information.
 
diff --git a/docs/cli/kops_create.md b/docs/cli/kops_create.md
index c899e8ae3c..4ed7fd8f21 100644
--- a/docs/cli/kops_create.md
+++ b/docs/cli/kops_create.md
@@ -1,11 +1,11 @@
 ## kops create
 
-Create a resource by filename or stdin
+Create a resource by filename or stdin.
 
 ### Synopsis
 
 
-Create a resource by filename or stdin
+Create a resource by filename or stdin.
 
 ```
 kops create -f FILENAME
diff --git a/docs/cli/kops_create_cluster.md b/docs/cli/kops_create_cluster.md
index 71b7a2cbfc..aa695b86ae 100644
--- a/docs/cli/kops_create_cluster.md
+++ b/docs/cli/kops_create_cluster.md
@@ -16,17 +16,20 @@ kops create cluster
 ```
       --admin-access stringSlice             Restrict access to admin endpoints (SSH, HTTPS) to this CIDR.  If not set, access will not be restricted by IP. (default [0.0.0.0/0])
       --associate-public-ip                  Specify --associate-public-ip=[true|false] to enable/disable association of public IP for master ASG and nodes. Default is 'true'.
+      --authorization string                 Authorization mode to use: AlwaysAllow or RBAC (default "AlwaysAllow")
       --bastion                              Pass the --bastion flag to enable a bastion instance group. Only applies to private topology.
       --channel string                       Channel for default versions and configuration to use (default "stable")
       --cloud string                         Cloud provider to use - gce, aws
       --cloud-labels string                  A list of KV pairs used to tag all instance groups in AWS (eg "Owner=John Doe,Team=Some Team").
       --dns string                           DNS hosted zone to use: public|private. Default is 'public'. (default "Public")
       --dns-zone string                      DNS hosted zone to use (defaults to longest matching zone)
+      --encrypt-etcd-storage                 Generate key in aws kms and use it for encrypt etcd volumes
       --image string                         Image to use
       --kubernetes-version string            Version of kubernetes to run (defaults to version in channel)
       --master-count int32                   Set the number of masters.  Defaults to one master per master-zone
       --master-security-groups stringSlice   Add precreated additional security groups to masters.
       --master-size string                   Set instance size for masters
+      --master-tenancy string                The tenancy of the master group on AWS. Can either be default or dedicated.
       --master-zones stringSlice             Zones in which to run masters (must be an odd number)
       --model string                         Models to apply (separate multiple models with commas) (default "config,proto,cloudup")
       --network-cidr string                  Set to override the default network CIDR
@@ -34,6 +37,7 @@ kops create cluster
       --node-count int32                     Set the number of nodes
       --node-security-groups stringSlice     Add precreated additional security groups to nodes.
       --node-size string                     Set instance size for nodes
+      --node-tenancy string                  The tenancy of the node group on AWS. Can be either default or dedicated.
       --out string                           Path to write any local output
       --project string                       Project to use (must be set on GCE)
       --ssh-public-key string                SSH public key to use (default "~/.ssh/id_rsa.pub")
@@ -60,5 +64,5 @@ kops create cluster
 ```
 
 ### SEE ALSO
-* [kops create](kops_create.md)	 - Create a resource by filename or stdin
+* [kops create](kops_create.md)	 - Create a resource by filename or stdin.
 
diff --git a/docs/cli/kops_create_instancegroup.md b/docs/cli/kops_create_instancegroup.md
index b97b9caff5..b5edee3458 100644
--- a/docs/cli/kops_create_instancegroup.md
+++ b/docs/cli/kops_create_instancegroup.md
@@ -14,7 +14,8 @@ kops create instancegroup
 ### Options
 
 ```
-      --role string   Type of instance group to create (Node,Master,Bastion) (default "Node")
+      --role string          Type of instance group to create (Node,Master,Bastion) (default "Node")
+      --subnet stringSlice   Subnets in which to create instance group
 ```
 
 ### Options inherited from parent commands
@@ -33,5 +34,5 @@ kops create instancegroup
 ```
 
 ### SEE ALSO
-* [kops create](kops_create.md)	 - Create a resource by filename or stdin
+* [kops create](kops_create.md)	 - Create a resource by filename or stdin.
 
diff --git a/docs/cli/kops_create_secret.md b/docs/cli/kops_create_secret.md
index b3b637da58..0109db7f3d 100644
--- a/docs/cli/kops_create_secret.md
+++ b/docs/cli/kops_create_secret.md
@@ -23,6 +23,6 @@ Create secrets.
 ```
 
 ### SEE ALSO
-* [kops create](kops_create.md)	 - Create a resource by filename or stdin
+* [kops create](kops_create.md)	 - Create a resource by filename or stdin.
 * [kops create secret sshpublickey](kops_create_secret_sshpublickey.md)	 - Create SSH publickey
 
diff --git a/docs/cli/kops_delete.md b/docs/cli/kops_delete.md
index 573348e98b..49cf897890 100644
--- a/docs/cli/kops_delete.md
+++ b/docs/cli/kops_delete.md
@@ -1,10 +1,11 @@
 ## kops delete
 
-Deletes a resource by filename or stdin
+Delete clusters and instancegroups
 
 ### Synopsis
 
-Delete clusters or instancegroups by filename or stdin
+
+Delete clusters and instancegroups
 
 ```
 kops delete -f FILENAME [--yes]
@@ -37,3 +38,4 @@ kops delete -f FILENAME [--yes]
 * [kops delete cluster](kops_delete_cluster.md)	 - Delete cluster
 * [kops delete instancegroup](kops_delete_instancegroup.md)	 - Delete instancegroup
 * [kops delete secret](kops_delete_secret.md)	 - Delete secret
+
diff --git a/docs/cli/kops_delete_cluster.md b/docs/cli/kops_delete_cluster.md
index a5fc82b325..a83a4d19e7 100644
--- a/docs/cli/kops_delete_cluster.md
+++ b/docs/cli/kops_delete_cluster.md
@@ -36,5 +36,5 @@ kops delete cluster CLUSTERNAME [--yes]
 ```
 
 ### SEE ALSO
-* [kops delete](kops_delete.md)	 - delete clusters
+* [kops delete](kops_delete.md)	 - Delete clusters and instancegroups
 
diff --git a/docs/cli/kops_delete_instancegroup.md b/docs/cli/kops_delete_instancegroup.md
index 5ff7391097..922f75272d 100644
--- a/docs/cli/kops_delete_instancegroup.md
+++ b/docs/cli/kops_delete_instancegroup.md
@@ -33,5 +33,5 @@ kops delete instancegroup
 ```
 
 ### SEE ALSO
-* [kops delete](kops_delete.md)	 - delete clusters
+* [kops delete](kops_delete.md)	 - Delete clusters and instancegroups
 
diff --git a/docs/cli/kops_delete_secret.md b/docs/cli/kops_delete_secret.md
index 34437da787..c6fd3136a0 100644
--- a/docs/cli/kops_delete_secret.md
+++ b/docs/cli/kops_delete_secret.md
@@ -27,5 +27,5 @@ kops delete secret
 ```
 
 ### SEE ALSO
-* [kops delete](kops_delete.md)	 - delete clusters
+* [kops delete](kops_delete.md)	 - Delete clusters and instancegroups
 
diff --git a/docs/cli/kops_describe.md b/docs/cli/kops_describe.md
index cc293fd7b7..24be1b6c0c 100644
--- a/docs/cli/kops_describe.md
+++ b/docs/cli/kops_describe.md
@@ -1,11 +1,11 @@
 ## kops describe
 
-describe objects
+Get additional information about cloud resources.
 
 ### Synopsis
 
 
-describe objects
+Get additional information about cloud resources.
 
 ### Options inherited from parent commands
 
diff --git a/docs/cli/kops_describe_secrets.md b/docs/cli/kops_describe_secrets.md
index 457382e2a3..bfb4bf5dbf 100644
--- a/docs/cli/kops_describe_secrets.md
+++ b/docs/cli/kops_describe_secrets.md
@@ -33,5 +33,5 @@ kops describe secrets
 ```
 
 ### SEE ALSO
-* [kops describe](kops_describe.md)	 - describe objects
+* [kops describe](kops_describe.md)	 - Get additional information about cloud resources.
 
diff --git a/docs/cli/kops_edit.md b/docs/cli/kops_edit.md
index 16a1fe77a5..ca03448e74 100644
--- a/docs/cli/kops_edit.md
+++ b/docs/cli/kops_edit.md
@@ -1,12 +1,12 @@
 ## kops edit
 
-Edit resource
+Edit clusters and other resrouces.
 
 ### Synopsis
 
 
 Edit a resource configuration.
-	
+
 This command changes the cloud specification in the registry.
 
 It does not update the cloud resources, to apply the changes use "kops update cluster".
diff --git a/docs/cli/kops_edit_cluster.md b/docs/cli/kops_edit_cluster.md
index 643395df3e..71220f130a 100644
--- a/docs/cli/kops_edit_cluster.md
+++ b/docs/cli/kops_edit_cluster.md
@@ -31,5 +31,5 @@ kops edit cluster
 ```
 
 ### SEE ALSO
-* [kops edit](kops_edit.md)	 - Edit resource
+* [kops edit](kops_edit.md)	 - Edit clusters and other resrouces.
 
diff --git a/docs/cli/kops_edit_federation.md b/docs/cli/kops_edit_federation.md
index 537a273789..64d5813797 100644
--- a/docs/cli/kops_edit_federation.md
+++ b/docs/cli/kops_edit_federation.md
@@ -27,5 +27,5 @@ kops edit federation
 ```
 
 ### SEE ALSO
-* [kops edit](kops_edit.md)	 - Edit resource
+* [kops edit](kops_edit.md)	 - Edit clusters and other resrouces.
 
diff --git a/docs/cli/kops_edit_instancegroup.md b/docs/cli/kops_edit_instancegroup.md
index 31e8bf50da..ec877ee688 100644
--- a/docs/cli/kops_edit_instancegroup.md
+++ b/docs/cli/kops_edit_instancegroup.md
@@ -31,5 +31,5 @@ kops edit instancegroup
 ```
 
 ### SEE ALSO
-* [kops edit](kops_edit.md)	 - Edit resource
+* [kops edit](kops_edit.md)	 - Edit clusters and other resrouces.
 
diff --git a/docs/cli/kops_export.md b/docs/cli/kops_export.md
index 8e6aabd3f6..9f0143cc87 100644
--- a/docs/cli/kops_export.md
+++ b/docs/cli/kops_export.md
@@ -1,6 +1,6 @@
 ## kops export
 
-export clusters/kubecfg
+Exports a kubecfg for target cluster.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_export_kubecfg.md b/docs/cli/kops_export_kubecfg.md
index 07df08ace9..aae9134603 100644
--- a/docs/cli/kops_export_kubecfg.md
+++ b/docs/cli/kops_export_kubecfg.md
@@ -27,5 +27,5 @@ kops export kubecfg CLUSTERNAME
 ```
 
 ### SEE ALSO
-* [kops export](kops_export.md)	 - export clusters/kubecfg
+* [kops export](kops_export.md)	 - Exports a kubecfg for target cluster.
 
diff --git a/docs/cli/kops_get.md b/docs/cli/kops_get.md
index 1c988941ea..1f7967fdbc 100644
--- a/docs/cli/kops_get.md
+++ b/docs/cli/kops_get.md
@@ -1,6 +1,6 @@
 ## kops get
 
-list or get objects
+List all instances of a resource.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_get_clusters.md b/docs/cli/kops_get_clusters.md
index 6cbe9b92ee..86eabe24ad 100644
--- a/docs/cli/kops_get_clusters.md
+++ b/docs/cli/kops_get_clusters.md
@@ -34,5 +34,5 @@ kops get clusters
 ```
 
 ### SEE ALSO
-* [kops get](kops_get.md)	 - list or get objects
+* [kops get](kops_get.md)	 - List all instances of a resource.
 
diff --git a/docs/cli/kops_get_federations.md b/docs/cli/kops_get_federations.md
index 21a7cd4674..e105b42001 100644
--- a/docs/cli/kops_get_federations.md
+++ b/docs/cli/kops_get_federations.md
@@ -28,5 +28,5 @@ kops get federations
 ```
 
 ### SEE ALSO
-* [kops get](kops_get.md)	 - list or get objects
+* [kops get](kops_get.md)	 - List all instances of a resource.
 
diff --git a/docs/cli/kops_get_instancegroups.md b/docs/cli/kops_get_instancegroups.md
index 52e0bd21fa..d0a8468f71 100644
--- a/docs/cli/kops_get_instancegroups.md
+++ b/docs/cli/kops_get_instancegroups.md
@@ -28,5 +28,5 @@ kops get instancegroups
 ```
 
 ### SEE ALSO
-* [kops get](kops_get.md)	 - list or get objects
+* [kops get](kops_get.md)	 - List all instances of a resource.
 
diff --git a/docs/cli/kops_get_secrets.md b/docs/cli/kops_get_secrets.md
index 1168bcc546..a49573b3e1 100644
--- a/docs/cli/kops_get_secrets.md
+++ b/docs/cli/kops_get_secrets.md
@@ -34,5 +34,5 @@ kops get secrets
 ```
 
 ### SEE ALSO
-* [kops get](kops_get.md)	 - list or get objects
+* [kops get](kops_get.md)	 - List all instances of a resource.
 
diff --git a/docs/cli/kops_import.md b/docs/cli/kops_import.md
index 463993c9dd..1f4731dd02 100644
--- a/docs/cli/kops_import.md
+++ b/docs/cli/kops_import.md
@@ -1,6 +1,6 @@
 ## kops import
 
-import clusters
+Import existing resources into the state store.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_import_cluster.md b/docs/cli/kops_import_cluster.md
index 83ea4693ec..591989bf8d 100644
--- a/docs/cli/kops_import_cluster.md
+++ b/docs/cli/kops_import_cluster.md
@@ -33,5 +33,5 @@ kops import cluster
 ```
 
 ### SEE ALSO
-* [kops import](kops_import.md)	 - import clusters
+* [kops import](kops_import.md)	 - Import existing resources into the state store.
 
diff --git a/docs/cli/kops_replace.md b/docs/cli/kops_replace.md
index cdb1207cfd..32c823cf44 100644
--- a/docs/cli/kops_replace.md
+++ b/docs/cli/kops_replace.md
@@ -1,11 +1,11 @@
 ## kops replace
 
-Replace a resource by filename or stdin
+Replace a resource by filename or stdin.
 
 ### Synopsis
 
 
-Replace a resource by filename or stdin
+Replace a resource by filename or stdin.
 
 ```
 kops replace -f FILENAME
diff --git a/docs/cli/kops_rolling-update.md b/docs/cli/kops_rolling-update.md
index 6565a64a44..aeea6fc41c 100644
--- a/docs/cli/kops_rolling-update.md
+++ b/docs/cli/kops_rolling-update.md
@@ -1,6 +1,6 @@
 ## kops rolling-update
 
-rolling update clusters
+Initiate rolling updates on clusters.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_rolling-update_cluster.md b/docs/cli/kops_rolling-update_cluster.md
index de822f9918..f214f039d4 100644
--- a/docs/cli/kops_rolling-update_cluster.md
+++ b/docs/cli/kops_rolling-update_cluster.md
@@ -47,5 +47,5 @@ kops rolling-update cluster
 ```
 
 ### SEE ALSO
-* [kops rolling-update](kops_rolling-update.md)	 - rolling update clusters
+* [kops rolling-update](kops_rolling-update.md)	 - Initiate rolling updates on clusters.
 
diff --git a/docs/cli/kops_secrets.md b/docs/cli/kops_secrets.md
index 5dfdcfdf20..c797326fc0 100644
--- a/docs/cli/kops_secrets.md
+++ b/docs/cli/kops_secrets.md
@@ -1,6 +1,6 @@
 ## kops secrets
 
-Manage secrets & keys
+Manage secrets & keys.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_secrets_create.md b/docs/cli/kops_secrets_create.md
index 8161bc17cf..2aecb7dd07 100644
--- a/docs/cli/kops_secrets_create.md
+++ b/docs/cli/kops_secrets_create.md
@@ -27,5 +27,5 @@ kops secrets create
 ```
 
 ### SEE ALSO
-* [kops secrets](kops_secrets.md)	 - Manage secrets & keys
+* [kops secrets](kops_secrets.md)	 - Manage secrets & keys.
 
diff --git a/docs/cli/kops_secrets_describe.md b/docs/cli/kops_secrets_describe.md
index 45bda3903a..5049dea240 100644
--- a/docs/cli/kops_secrets_describe.md
+++ b/docs/cli/kops_secrets_describe.md
@@ -27,5 +27,5 @@ kops secrets describe
 ```
 
 ### SEE ALSO
-* [kops secrets](kops_secrets.md)	 - Manage secrets & keys
+* [kops secrets](kops_secrets.md)	 - Manage secrets & keys.
 
diff --git a/docs/cli/kops_secrets_expose.md b/docs/cli/kops_secrets_expose.md
index cad005daf3..1ca0506780 100644
--- a/docs/cli/kops_secrets_expose.md
+++ b/docs/cli/kops_secrets_expose.md
@@ -27,5 +27,5 @@ kops secrets expose
 ```
 
 ### SEE ALSO
-* [kops secrets](kops_secrets.md)	 - Manage secrets & keys
+* [kops secrets](kops_secrets.md)	 - Manage secrets & keys.
 
diff --git a/docs/cli/kops_secrets_get.md b/docs/cli/kops_secrets_get.md
index 4943bf30a3..8ec2d97bd3 100644
--- a/docs/cli/kops_secrets_get.md
+++ b/docs/cli/kops_secrets_get.md
@@ -27,5 +27,5 @@ kops secrets get
 ```
 
 ### SEE ALSO
-* [kops secrets](kops_secrets.md)	 - Manage secrets & keys
+* [kops secrets](kops_secrets.md)	 - Manage secrets & keys.
 
diff --git a/docs/cli/kops_toolbox.md b/docs/cli/kops_toolbox.md
index df5112cf4d..1d0732c1be 100644
--- a/docs/cli/kops_toolbox.md
+++ b/docs/cli/kops_toolbox.md
@@ -1,11 +1,11 @@
 ## kops toolbox
 
-Misc infrequently used commands
+Misc infrequently used commands.
 
 ### Synopsis
 
 
-Misc infrequently used commands
+Misc infrequently used commands.
 
 ### Options inherited from parent commands
 
diff --git a/docs/cli/kops_toolbox_convert-imported.md b/docs/cli/kops_toolbox_convert-imported.md
index 190fc34da0..ebb305791d 100644
--- a/docs/cli/kops_toolbox_convert-imported.md
+++ b/docs/cli/kops_toolbox_convert-imported.md
@@ -34,5 +34,5 @@ kops toolbox convert-imported
 ```
 
 ### SEE ALSO
-* [kops toolbox](kops_toolbox.md)	 - Misc infrequently used commands
+* [kops toolbox](kops_toolbox.md)	 - Misc infrequently used commands.
 
diff --git a/docs/cli/kops_toolbox_dump.md b/docs/cli/kops_toolbox_dump.md
index 626aebcd35..a58145cc38 100644
--- a/docs/cli/kops_toolbox_dump.md
+++ b/docs/cli/kops_toolbox_dump.md
@@ -33,5 +33,5 @@ kops toolbox dump
 ```
 
 ### SEE ALSO
-* [kops toolbox](kops_toolbox.md)	 - Misc infrequently used commands
+* [kops toolbox](kops_toolbox.md)	 - Misc infrequently used commands.
 
diff --git a/docs/cli/kops_update.md b/docs/cli/kops_update.md
index 779e725e8c..9452eb8288 100644
--- a/docs/cli/kops_update.md
+++ b/docs/cli/kops_update.md
@@ -1,6 +1,6 @@
 ## kops update
 
-update clusters
+Creates or updates cloud resources to match cluster spec.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_update_cluster.md b/docs/cli/kops_update_cluster.md
index cfffc71eea..216a9c9e70 100644
--- a/docs/cli/kops_update_cluster.md
+++ b/docs/cli/kops_update_cluster.md
@@ -38,5 +38,5 @@ kops update cluster
 ```
 
 ### SEE ALSO
-* [kops update](kops_update.md)	 - update clusters
+* [kops update](kops_update.md)	 - Creates or updates cloud resources to match cluster spec.
 
diff --git a/docs/cli/kops_update_federation.md b/docs/cli/kops_update_federation.md
index ba608bde2f..3a411e78ce 100644
--- a/docs/cli/kops_update_federation.md
+++ b/docs/cli/kops_update_federation.md
@@ -27,5 +27,5 @@ kops update federation
 ```
 
 ### SEE ALSO
-* [kops update](kops_update.md)	 - update clusters
+* [kops update](kops_update.md)	 - Creates or updates cloud resources to match cluster spec.
 
diff --git a/docs/cli/kops_upgrade.md b/docs/cli/kops_upgrade.md
index d3b4dcefdf..1e0ffd1a4f 100644
--- a/docs/cli/kops_upgrade.md
+++ b/docs/cli/kops_upgrade.md
@@ -1,6 +1,6 @@
 ## kops upgrade
 
-upgrade clusters
+Automates checking for and applying Kubernetes updates.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_upgrade_cluster.md b/docs/cli/kops_upgrade_cluster.md
index 282126f185..b6b0b5a7db 100644
--- a/docs/cli/kops_upgrade_cluster.md
+++ b/docs/cli/kops_upgrade_cluster.md
@@ -34,5 +34,5 @@ kops upgrade cluster
 ```
 
 ### SEE ALSO
-* [kops upgrade](kops_upgrade.md)	 - upgrade clusters
+* [kops upgrade](kops_upgrade.md)	 - Automates checking for and applying Kubernetes updates.
 
diff --git a/docs/cli/kops_validate.md b/docs/cli/kops_validate.md
index db2f64695c..895d3797ab 100644
--- a/docs/cli/kops_validate.md
+++ b/docs/cli/kops_validate.md
@@ -1,6 +1,6 @@
 ## kops validate
 
-Validate Cluster
+Run validation check on Kubernetes cluster.
 
 ### Synopsis
 
diff --git a/docs/cli/kops_validate_cluster.md b/docs/cli/kops_validate_cluster.md
index c4899edcc1..295d24df6b 100644
--- a/docs/cli/kops_validate_cluster.md
+++ b/docs/cli/kops_validate_cluster.md
@@ -27,5 +27,5 @@ kops validate cluster
 ```
 
 ### SEE ALSO
-* [kops validate](kops_validate.md)	 - Validate Cluster
+* [kops validate](kops_validate.md)	 - Run validation check on Kubernetes cluster.
 
diff --git a/docs/cli/kops_version.md b/docs/cli/kops_version.md
index 9146654a8d..ca43daf3ed 100644
--- a/docs/cli/kops_version.md
+++ b/docs/cli/kops_version.md
@@ -1,11 +1,11 @@
 ## kops version
 
-Print the client version information
+Print the client version information.
 
 ### Synopsis
 
 
-Print the client version information
+Print the client version information.
 
 ```
 kops version