Various docs fixes

Author: prachirp

README.md

@@ -1,12 +1,12 @@
 # kubebuilder-declarative-pattern
 
-kubebuilder-declarative-pattern provides a set of tools for building declarative cluster operators with kubebuilder. Declarative operators provide a fast path to orchestrating Kubernetes deployments to enable domain experts to focus their component instead of re-answering questions like 'how do I get this YAML into the cluster?' or 'how do I update it?'.
+kubebuilder-declarative-pattern provides a set of tools for building declarative cluster operators with kubebuilder. Declarative operators provide a fast path to orchestrating Kubernetes deployments to enable domain experts to focus on their component instead of re-answering questions like 'How do I get this YAML into the cluster?' or 'How do I update it?'.
 
 ## Development
 
 ### Running Smoke Tests
 
-Smoke tests are provided to ensure basic functinality of the framework against example operators. They should be ran as part of significant code changes. The tests require a running Kubernetes cluster to be targeted from the local machine and write access to a GCR bucket.
+Smoke tests are provided to ensure basic functionality of the framework against example operators. They should be run as part of significant code changes. The tests require a running Kubernetes cluster to be targeted from the local machine and write access to a GCR bucket.
 
 ```bash
 cd hack

docs/addon/walkthrough/README.md

@@ -7,12 +7,12 @@ This walkthrough is for creating an operator to run the [guestbook](https://gith
 Install the following depenencies:
 
 - [kubebuilder](https://book.kubebuilder.io/quick-start.html#installation) (tested with 2.0.0-alpha.4)
-- [kustomize](https://github.com/kubernetes-sigs/kustomize/blob/master/docs/INSTALL.md) (tested with v2.0.3)
+- [kustomize](https://kubectl.docs.kubernetes.io/installation/kustomize/) (tested with v2.0.3)
 - docker
 - kubectl
 - golang (>=1.11 for go modules)
 
-Create a new directory and use kubebuilder to scafold the operator:
+Create a new directory and use kubebuilder to scaffold the operator:
 
 ```
 export GO111MODULE=on
@@ -53,7 +53,7 @@ when [server-side-apply](https://github.com/kubernetes/enhancements/issues/555)
 is available we'll use that.
 
 We suggest that even advanced operators use a manifest for their core objects.
-It's always possible to manipulate the manifest before applying them (eg, adding labels,
+It's always possible to manipulate the manifest before applying it (eg, adding labels,
 changing namespaces, and tweaking flags)
 
 Some other advantages:

docs/addon/walkthrough/tests.md

@@ -150,7 +150,7 @@ cp config/samples/* k8s/resources
 ### Adding Tests
 
 For this example, we will be adding a test for KubeDNS. 
-All code changes will live in [smoketest.go](../../smoketest.go).
+All code changes will live in [smoketest.go](../../../hack/smoketest.go).
 
 1. Create a test class that inherits from `CommonAddonsTest` and a constructor.