updates from PR review

.github/ISSUE_TEMPLATE.md

@@ -3,21 +3,29 @@ you can.
 
 ------------- BUG REPORT TEMPLATE --------------------
 
-1. What kops version are you running? Use `kops version`?
+1. What `kops` version are you running? The command `kops version`, will display
+ this information.
 
-1. What Kubernetes version are you running? Use `kubectl version`?
+1. What Kubernetes version are you running? `kubectl version` will print the
+ version if a cluster is running or provide the Kubernetes version specified as
+ a `kops` flag.
 
 1. What cloud provider are you using?
 
-1. What commands did you execute, and what happened after the commands executed?
+1. What commands did you run?
 
-1. Can you provide cluster manifest `kops get --name my.example.com -oyaml`?
+1. What happened after the commands executed?
 
-1. What you expected to happen?
+1. Please provide your cluster manifest. Execute
+  `kops get --name my.example.com -oyaml` to display your cluster manifest.
+  You may want to remove your cluster name and other sensitive information.
 
-1. How can we to reproduce it (as minimally and precisely as possible)?
+1. What did you expect to happen?
 
-1. Can you run the `kops` command with the `-v 10` flag and provide logs?
+1. What is the simplest way to reproduce this issue?
+
+1. Please run the commands with most verbose logging by adding the `-v 10` flag.
+  Paste the logs into this report, or in a gist and provide the gist link here.
 
 1. Anything else do we need to know?
 

README.md

@@ -59,17 +59,26 @@ Documentation is in the `/docs` directory, [and the index is here.](docs/README.
 
 ## Kubernetes Release Compatibility
 
-`kops` is intended to be backward compatible.  It is always recommended to use the 
-latest version of kop with whatever version of Kuberentes you are using. This 
-project does not follow the Kubernetes release schedule but typically releases 
-after Kubernetes does.  `kops` supports the matching Kubernetes minor release.  
-For instance kops, 1.8.x does not support Kubernetes 1.9.x, but kops 1.9.x 
-supports Kubernetes 1.9.x.  Moreover, kops 1.8.x attempts to be backward compatible 
-and support Kubernetes 1.4.x.
-
+`kops` is intended to be backward compatible.  It is always recommended to use
+the latest version of kops with whatever version of Kubernetes you are using.
+`kops` supports the matching Kubernetes minor release.   For instance kops,
+1.8.x does not support Kubernetes 1.9.x, but kops 1.9.x  supports Kubernetes
+1.9.x.  Moreover, kops 1.8.x attempts to be backward compatible and support
+Kubernetes 1.4.x.
+
+This project does not follow the Kubernetes release schedule.  `kops` aims to
+provide a reliable installation experience for kubernetes, and typically
+releases about a month after the corresponding Kubernetes release. This time
+allows for release issues in Kubernetes and ensures that we can support the
+latest features. kops will release alpha and beta pre-releases before then for
+people that are eager to try the latest kubernetes release and have environments
+where they can tolerate the quirks of new releases, and please do report any
+issues encountered.
 
 ## Installing
 
+### Prerequisite
+
 `kubectl` is required, see [here](http://kubernetes.io/docs/user-guide/prereqs/).