more updates

README.md

@@ -4,7 +4,7 @@
 
 The easiest way to get a production grade Kubernetes cluster up and running.
 
-## What is `kops`?
+## What is kops?
 
 We like to think of it as `kubectl` for clusters.
 
@@ -12,29 +12,29 @@ We like to think of it as `kubectl` for clusters.
 options that support HA Masters. Kubernetes Operations supports deploying
 Kubernetes on Amazon Web Services (AWS) and support for more platforms is planned.
 
-## Launching a Kubernetes cluster in AWS
+## Launching a Kubernetes hosted on AWS
 
-Check out our [tutorial](/docs/aws.md) on launching a Kubernetes cluster in AWS.
+Check out our [tutorial](/docs/aws.md) for launching a Kubernetes cluster hosted
+on AWS.
 
 <p align="center">
   <img src="/docs/img/demo.gif" width="885" > </image>
 </p>
 
-
 ## Features
 
-* Automated Kubernetes cluster [CRUD](/docs/commands.md) for the ([AWS](/docs/aws.md))
+* Automated Kubernetes cluster [CRUD](/docs/commands.md) for ([AWS](/docs/aws.md))
 * Highly Available (HA) Kubernetes Masters Setup
 * Uses a state-sync model for **dry-run** and automatic **idempotency**
-* Custom support for `kubectl` [add-ons](docs/addons.md)
+* Custom support for `kubectl` [add-ons](/docs/addons.md)
 * Kops can generate [Terraform configuration](/docs/terraform.md)
 * Based on a simple meta-model defined in a directory tree
-* Easy command line syntax with autocomplete
+* Command line [autocomplete](/docs/cli/kops_completion.md)
 * Community support
 
 ## Installing
 
-`kubectl` is required. Install [instructions](http://kubernetes.io/docs/user-guide/prereqs/).
+`kubectl` is required, see [here](http://kubernetes.io/docs/user-guide/prereqs/).
 
 <!-- Move this to an install guide -->
 
@@ -93,25 +93,26 @@ have time to prepare for the call.
 | [@kris-nova](https://github.com/kris-nova)           |  2nd / 4th Friday 9am PDT | [Zoom](https://zoom.us/my/k8ssigaws) |
 
 Reach out to us on [kubernetes slack](https://github.com/kubernetes/community#slack-chat).
-A great place to get involved or ask questions is [#sig-cluster-lifecycle](https://kubernetes.slack.com/?redir=%2Fmessages%2Fsig-cluster-lifecycle%2F)
+A great place to get involved or ask questions is [#sig-cluster-lifecycle](https://kubernetes.slack.com/?redir=%2Fmessages%2Fsig-cluster-lifecycle%2F).
 
 ## Other Resources
 
- - Create [kubecfg settings for kubectl](docs/tips.md#create-kubecfg-settings-for-kubectl)
- - Set up [add-ons](docs/addons.md), to add important functionality to Kubernetes
- - Learn about [InstanceGroups](docs/instance_groups.md), which let you change
- instance types, cluster sizes, and other options
- - Read about [networking options](docs/networking.md)
- - Look at our [other interesting modes](docs/commands.md#other-interesting-modes)
- - Full command line interface [documentation](docs/cli/kops.md)
+ - Create [kubecfg settings for kubectl](/docs/tips.md#create-kubecfg-settings-for-kubectl)
+ - Set up [add-ons](/docs/addons.md), to add important functionality to Kubernetes
+ - Learn about [InstanceGroups](/docs/instance_groups.md); change
+ instance types, number of nodes, and other options
+ - Read about [networking options](/docs/networking.md)
+ - Look at our [other interesting modes](/docs/commands.md#other-interesting-modes)
+ - Full command line interface [documentation](/docs/cli/kops.md)
 
 ## History
 
 View our [changelog](HISTORY.md)
 
-## Bugs
+## Issues
 
-If you think you have found a bug:
+If you think you have found a bug or want to recommend a new feature follow the
+instructions below.
 
 - Set `--v=10` command line option and save the log output
 - Note you version of `kops`, and the command line options you are using