Improve installation docs

Author: ThomasVitale

README.md

@@ -2,58 +2,52 @@
 
 This project provides a [Carvel package](https://carvel.dev/kapp-controller/docs/latest/packaging) for [Cert Manager](https://cert-manager.io), a cloud-native solution to automatically provision and manage TLS certificates in Kubernetes.
 
-## Components
-
-* Cert Manager
-
 ## Prerequisites
 
-* Install the [`kctrl`](https://carvel.dev/kapp-controller/docs/latest/install/#installing-kapp-controller-cli-kctrl) CLI to manage Carvel packages in a convenient way.
-* Ensure [kapp-controller](https://carvel.dev/kapp-controller) is deployed in your Kubernetes cluster. You can do that with Carvel
-[`kapp`](https://carvel.dev/kapp/docs/latest/install) (recommended choice) or `kubectl`.
+* Kubernetes 1.24+
+* Carvel [`kctrl`](https://carvel.dev/kapp-controller/docs/latest/install/#installing-kapp-controller-cli-kctrl) CLI.
+* Carvel [kapp-controller](https://carvel.dev/kapp-controller) deployed in your Kubernetes cluster. You can install it with Carvel [`kapp`](https://carvel.dev/kapp/docs/latest/install) (recommended choice) or `kubectl`.
 
-```shell
-kapp deploy -a kapp-controller -y \
-  -f https://github.com/vmware-tanzu/carvel-kapp-controller/releases/latest/download/release.yml
-```
+  ```shell
+  kapp deploy -a kapp-controller -y \
+    -f https://github.com/vmware-tanzu/carvel-kapp-controller/releases/latest/download/release.yml
+  ```
 
 ## Installation
 
-You can install the Cert Manager package directly or rely on the [Kadras package repository](https://github.com/arktonix/carvel-packages)
-(recommended choice).
-
-Follow the [instructions](https://github.com/arktonix/carvel-packages) to add the Kadras package repository to your Kubernetes cluster.
+First, add the [Kadras package repository](https://github.com/arktonix/kadras-packages) to your Kubernetes cluster.
 
-If you don't want to use the Kadras package repository, you can create the necessary `PackageMetadata` and
-`Package` resources for the Cert Manager package directly.
-
-```shell
-kubectl create namespace carvel-packages
-kapp deploy -a cert-manager-package -n carvel-packages -y \
-    -f https://github.com/arktonix/package-for-cert-manager/releases/latest/download/metadata.yml \
-    -f https://github.com/arktonix/package-for-cert-manager/releases/latest/download/package.yml
-```
+  ```shell
+  kubectl create namespace kadras-packages
+  kctrl package repository add -r kadras-repo \
+    --url ghcr.io/arktonix/kadras-packages \
+    -n kadras-packages
+  ```
 
-Either way, you can then install the Cert Manager package using [`kctrl`](https://carvel.dev/kapp-controller/docs/latest/install/#installing-kapp-controller-cli-kctrl).
+Then, install the Cert Manager package.
 
-```shell
-kctrl package install -i cert-manager \
+  ```shell
+  kctrl package install -i cert-manager \
     -p cert-manager.packages.kadras.io \
     -v 1.10.1 \
-    -n carvel-packages
-```
+    -n kadras-packages
+  ```
+
+### Verification
+
+You can verify the list of installed Carvel packages and their status.
 
-You can retrieve the list of available versions with the following command.
+  ```shell
+  kctrl package installed list -n kadras-packages
+  ```
 
-```shell
-kctrl package available list -p cert-manager.packages.kadras.io
-```
+### Version
 
-You can check the list of installed packages and their status as follows.
+You can get the list of versions available in the Kadras package repository for Cert Manager.
 
-```shell
-kctrl package installed list -n carvel-packages
-```
+  ```shell
+  kctrl package available list -p cert-manager.packages.kadras.io -n kadras-packages
+  ```
 
 ## Configuration
 
@@ -65,23 +59,53 @@ The Cert Manager package has the following configurable properties.
 
 You can define your configuration in a `values.yml` file.
 
-```yaml
-namespace: cert-manager
-```
+  ```yaml
+  namespace: cert-manager
+  ```
 
-Then, reference it from the `kctrl` command when installing or upgrading the package.
+Then, pass the file when installing the package.
 
-```shell
-kctrl package install -i cert-manager \
+  ```shell
+  kctrl package install -i cert-manager \
     -p cert-manager.packages.kadras.io \
     -v 1.10.1 \
-    -n carvel-packages \
+    -n kadras-packages \
     --values-file values.yml
-```
+  ```
+
+## Upgrading
+
+You can upgrade an existing package to a newer version using `kctrl`.
+
+  ```shell
+  kctrl package installed update -i cert-manager \
+    -v <new-version> \
+    -n kadras-packages
+  ```
+
+You can also update an existing package with a newer `values.yml` file.
+
+  ```shell
+  kctrl package installed update -i cert-manager \
+    -n kadras-packages \
+    --values-file values.yml
+  ```
+
+## Other
+
+The recommended way of installing the Cert Manager package is via the [Kadras package repository](https://github.com/arktonix/kadras-packages). If you prefer not using the repository, you can install the package by creating the necessary Carvel `PackageMetadata` and `Package` resources directly
+using [`kapp`](https://carvel.dev/kapp/docs/latest/install) or `kubectl`.
+
+  ```shell
+  kubectl create namespace kadras-packages
+  kapp deploy -a cert-manager-package -n kadras-packages -y \
+    -f https://github.com/arktonix/package-for-cert-manager/releases/latest/download/metadata.yml \
+    -f https://github.com/arktonix/package-for-cert-manager/releases/latest/download/package.yml
+  ```
 
-## Documentation
+## Support and Documentation
 
-For documentation specific to Cert Manager, check out [cert-manager.io](https://cert-manager.io).
+For support and documentation specific to Cert Manager, check out [cert-manager.io](https://cert-manager.io).
 
 ## References