docs: Update installation guide

Signed-off-by: Alex Collins <[email protected]>

README.md

@@ -69,7 +69,7 @@ Check out our [Java, Golang and Python SDKs](https://github.com/argoproj-labs/ar
 
 ```bash
 kubectl create namespace argo
-kubectl apply -n argo -f https://raw.githubusercontent.com/argoproj/argo-workflows/stable/manifests/install.yaml
+kubectl apply -n argo -f https://raw.githubusercontent.com/argoproj/argo-workflows/master/manifests/install.yaml
 ```
 
 ## Who uses Argo Workflows?

docs/installation.md

@@ -2,20 +2,17 @@
 
 You can choose one of three common installations:
 
-* **cluster install** Execute workflows in any namespace? 
+* **cluster install** Execute workflows in any namespace?
 * **namespace install** Only execute workflows in the same namespace we install in (typically `argo`).
 * **managed namespace install**: Only execute workflows in a specific namespace ([learn more](managed-namespace.md)).
 
-Choose [a manifests from the list](https://github.com/argoproj/argo-workflows/tree/stable/manifests).
-
-E.g.
-
-```sh
-kubectl create ns argo
-kubectl apply -n argo -f https://raw.githubusercontent.com/argoproj/argo-workflows/stable/manifests/namespace-install.yaml 
-```
-
+## Recommendations
 
+* Make sure you're using the manifests attached to the release.
+* Read the [upgrading guide](upgrading.md) before any major upgrade to be aware of breaking changes.
+* If you are using GitOps, copy the manifests into your repository, rather use `base` to reference them. Fewer issues
+  regarding network loss, and you'll be able to check what has changed each time you upgrade.
+* Double-check you have the right version of your executor configured, it's easy to miss.
 
 
 

docs/quick-start.md

@@ -10,7 +10,7 @@ To get started quickly, you can use the quick start manifest which will install
 
 ```sh
 kubectl create ns argo
-kubectl apply -n argo -f https://raw.githubusercontent.com/argoproj/argo-workflows/stable/manifests/quick-start-postgres.yaml
+kubectl apply -n argo -f https://raw.githubusercontent.com/argoproj/argo-workflows/master/manifests/quick-start-postgres.yaml
 ```
 
 !!! note