Apply suggestions from code review

Co-Authored-By: Mateusz Szostok <[email protected]>

README.md

@@ -34,7 +34,7 @@ Open Service Broker API project's [Getting Started guide](https://github.com/ope
 
 ### Project Status
 
-Service Catalog recently switched to a new [CRDs-based](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/#custom-resources) architecture. The old API Server-based implementation is available on the [v0.2 branch](https://github.com/kubernetes-sigs/service-catalog/tree/v0.2). We plan to support this implementation by providing bug fixes until July 2020.
+Service Catalog recently switched to a new [CRDs-based](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/#custom-resources) architecture. The old API Server-based implementation is available on the [v0.2 branch](https://github.com/kubernetes-sigs/service-catalog/tree/v0.2). We support this implementation by providing bug fixes until July 2020.
 
 We are currently working towards a beta-quality release. See the [milestones list](https://github.com/kubernetes-sigs/service-catalog/milestones?direction=desc&sort=due_date&state=open)
 for information about the issues and PRs in current and future milestones.

docs/install.md

@@ -108,9 +108,9 @@ helm search service-catalog
 You should see the following output:
 
 ```console
-NAME           	VERSION	DESCRIPTION
-svc-cat-kyma/catalog          0.3.X  service-catalog
-svc-cat-kyma/catalog-v0.2	 0.2.X  service-catalog API server ....
+NAME                         VERSION	DESCRIPTION
+svc-cat-kyma/catalog         0.3.X      service-catalog
+svc-cat-kyma/catalog-v0.2    0.2.X      service-catalog API server ...
 ```
 
 ## RBAC
@@ -177,15 +177,19 @@ helm install svc-cat/catalog-v0.2 \
 
 Follow the appropriate instructions for your operating system to install svcat. The binary can be used by itself, or as a kubectl plugin.
 
-The snippets below install the latest version of svcat. We also publish binaries for our canary (master) builds, and tags using the following prefixes:
+The snippets below install the latest version of svcat. We also publish binaries for our canary builds, and tags using the following prefixes:
+* Latest release:
+  * [master](https://github.com/kubernetes-sigs/service-catalog/tree/master) branch: https://download.svcat.sh/cli/latest
+  * [v0.2](https://github.com/kubernetes-sigs/service-catalog/tree/v0.2) branch: https://download.svcat.sh/cli/latest-v0.2
+* Canary builds:
+  * [master](https://github.com/kubernetes-sigs/service-catalog/tree/master) branch: https://download.svcat.sh/cli/canary
+  * [v0.2](https://github.com/kubernetes-sigs/service-catalog/tree/v0.2) branch: https://download.svcat.sh/cli/canary-v0.2
 
-* Latest release: https://download.svcat.sh/cli/latest
-* Latest release from v2 branch: https://download.svcat.sh/cli/latest-v2.0
 * Tagged releases: https://download.svcat.sh/cli/VERSION
-  where `VERSION` is the release, for example `v0.1.20`.
-* Canary builds: https://download.svcat.sh/cli/canary
+  where `VERSION` is the release, for example `v0.3.0`, `v0.2.1`, etc.
+
 * Previous canary builds: https://download.svcat.sh/cli/VERSION-GITDESCRIBE
-  where `GITDESCRIBE` is the result of calling `git describe --tags`, for example `v0.1.20-1-g203c8ad`.
+  where `GITDESCRIBE` is the result of calling `git describe --tags`,  for example `v0.3.0-1-g84216bdf`, `v0.2.1-1-g203c8ad` etc.
 
 ## MacOS with Homebrew