Minor documentation refactoring (kubernetes-sigs#2365)

Author: kishen-v

docs/book/src/topics/capibmadm/index.md

@@ -4,55 +4,17 @@ Kubernetes Cluster API Provider IBM Cloud Management Utility
 
 ## Install capibmadm
 
-#### Install capibmadm binary with curl on Linux
-If you are unsure you can determine your computers architecture by running `uname -a`
+#### Install capibmadm binary with curl on Linux / MacOS
+Run the following command to download the capibmadm binary:
 
-Download for AMD64:
 ```bash
-curl -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.7.0/capibmadm-linux-amd64 -o capibmadm
+curl -L "https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.11.0/capibmadm-$(echo "$(uname -s)" | tr A-Z a-z)-$(uname -m)" -o capibmadm
 ```
-
-Download for ARM64:
-```bash
-curl -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.7.0/capibmadm-linux-arm64 -o capibmadm
-```
-
-Download for PPC64LE:
-```bash
-curl -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.7.0/capibmadm-linux-ppc64le -o capibmadm
-```
-
-Make the capibmadm binary executable.
-```bash
-chmod +x ./capibmadm
-```
-Move the binary in to your PATH.
-```bash
-sudo mv ./capibmadm /usr/local/bin/capibmadm
-```
-Test to ensure the version you installed is up-to-date:
-```bash
-capibmadm version -o short
-```
-
-#### Install capibmadm binary with curl on macOS
-If you are unsure you can determine your computers architecture by running `uname -a`
-
-Download for AMD64:
-```bash
-curl -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.7.0/capibmadm-darwin-amd64 -o capibmadm
-```
-
-Download for M1 CPU ("Apple Silicon") / ARM64:
-```bash
-curl -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.7.0/capibmadm-darwin-arm64 -o capibmadm
-```
-
-Make the capibmadm binary executable.
+Add the execute bit to the binary.
 ```bash
 chmod +x ./capibmadm
 ```
-Move the binary in to your PATH.
+Move the binary to $PATH.
 ```bash
 sudo mv ./capibmadm /usr/local/bin/capibmadm
 ```
@@ -66,13 +28,13 @@ Go to the working directory where you want capibmadm downloaded.
 
 Download the latest release on AMD64; on Windows, type:
 ```powershell
-curl.exe -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.7.0/capibmadm-windows-amd64.exe -o capibmadm.exe
+curl.exe -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.11.0/capibmadm-windows-amd64.exe -o capibmadm.exe
 ```
 Append or prepend the path of that directory to the `PATH` environment variable.
 
 Download the latest release on ARM64; on Windows, type:
 ```powershell
-curl.exe -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.7.0/capibmadm-windows-arm64.exe -o capibmadm.exe
+curl.exe -L https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud/releases/download/v0.11.0/capibmadm-windows-arm64.exe -o capibmadm.exe
 ```
 Append or prepend the path of that directory to the `PATH` environment variable.
 

docs/book/src/topics/vpc/uploading-an-image.md

@@ -44,7 +44,7 @@ Service VPC Infrastructure Services in Resource_group <your_resource_group_or_ac
 target: service Cloud object storage in resource_group <your_resource_group_or_account>
 ```
 
-3) Go to https://cloud.ibm.com/vpc-ext/provision/customImage
+3) Go to [https://cloud.ibm.com/vpc-ext/provision/customImage](https://cloud.ibm.com/vpc-ext/provision/customImage)
   * Fill in imagename, resource group or account
   * Choice box: Cloud Object Storage
   * Set Filter: <your_cos_plain_name> <eu-de_or_other> <your_vm_bucket>