Readme updates (#2053)

* fix readmes to provide yaml install - links from helm to controller readmes

Author: pwright

charts/README.md

@@ -2,25 +2,9 @@
 
 ### Skupper chart
 
-The skupper chart is generated from common config files, so you will need to run:
-```asciidoc
-make generate-skupper-helm-chart
-```
-
-This action will create a `skupper` chart inside the `charts` directory, that 
-you can install with a clustered scope with:
-```
-helm install skupper ./skupper --set scope=cluster
-```
-Other option is to install it in a namespaced scope:
-```
-helm install skupper ./skupper --set scope=namespace
-```
-
-Check the `values.yaml` to modify the image tag of the controller, kube-adaptor and router images. 
-
+[Instructions on how to deploy the Skupper chart](skupper/README.md)
 
 ### Network-observer chart
 
-[Instructions on how to deploy the network-observer chart.](https://github.com/skupperproject/skupper/blob/main/charts/network-observer/README.md) 
+[Instructions on how to deploy the network-observer chart](network-observer/README.md) 
 

charts/skupper/README.md

@@ -52,18 +52,24 @@ routerImage:        examplemirror.acme.com/skupper/skupper-router:3.3.0
 
 ## Alternative Installation Methods
 
-In addition to this Helm Chart, Skupper releases static manifest yamls for
+In addition to this Helm Chart, Skupper releases static manifest [YAML](../../cmd/controller/README.md) for
 deploying both cluster and namespace-scoped controllers.
 
-```
-SKUPPER_VERSION=2.0.0
-# Deploys a cluster scoped controller to the 'skupper' namespace.
-kubectl apply -f "https://github.com/skupperproject/skupper/releases/download/$SKUPPER_VERSION/skupper-cluster-scope.yaml"
-# Deploys a namespace scoped controller to the current context namespace.
-kubectl apply -f "https://github.com/skupperproject/skupper/releases/download/$SKUPPER_VERSION/skupper-namespace-scope.yaml"
+## Development
+
+The skupper chart is generated from common config files, so you will need to run:
+```asciidoc
+make generate-skupper-helm-chart
 ```
 
-## Development
+This action will create a `skupper` chart inside the `charts` directory, that 
+you can install with a clustered scope with:
+```
+helm install skupper ./skupper --set scope=cluster
+```
+Other option is to install it in a namespaced scope:
+```
+helm install skupper ./skupper --set scope=namespace
+```
 
-This Helm Chart is generated. For instructions on working with this chart see
-[skupper/charts](https://github.com/skupperproject/skupper/tree/main/charts).
+Check the `values.yaml` to modify the image tag of the controller, kube-adaptor and router images. 

cmd/controller/README.md

@@ -0,0 +1,20 @@
+# Skupper controller
+
+Skupper releases static manifest yamls for deploying both cluster and namespace-scoped controllers.
+
+```
+SKUPPER_VERSION=v2-dev-release
+# Deploys a cluster scoped controller to the 'skupper' namespace.
+kubectl apply -f "https://github.com/skupperproject/skupper/releases/download/$SKUPPER_VERSION/skupper-cluster-scope.yaml"
+# Deploys a namespace scoped controller to the current context namespace.
+kubectl apply -f "https://github.com/skupperproject/skupper/releases/download/$SKUPPER_VERSION/skupper-namespace-scope.yaml"
+```
+
+Alternatively, clone this repo and generate the YAML files using:
+
+```
+make generate-skupper-deployment-cluster-scoped
+make generate-skupper-deployment-namespace-scoped
+```
+
+You can also install using [Helm charts](../../charts/README.md).

cmd/controller/example/README.md

@@ -4,8 +4,10 @@ This example demonstrates how to connect two sites declaratively, without relyin
 
 ## Installing the skupper controller
 
-The controller can be installed using the Helm chart, with detailed instructions provided
- [here](https://github.com/skupperproject/skupper/blob/main/charts/README.md)  
+The controller can be installed using:
+
+* [YAML](../README.md)
+* [Helm chart](../../../charts/README.md)  
 
 ## Deploy application in two namespaces (or contexts)