diff --git a/h.helm.md b/h.helm.md
index 347688ca..9050f61c 100644
--- a/h.helm.md
+++ b/h.helm.md
@@ -4,122 +4,145 @@
 
 ## Helm in K8s
 
-### Creating a basic Helm chart
+### Creating a Basic Helm chart
 
 <details><summary>show</summary>
 <p>
 
 ```bash
-helm create chart-test ## this would create a helm 
+helm create chart-test ## this creates a basic helm chart
 ```
 
 </p>
 </details>
 
-### Running a Helm chart
-
+### Add the Bitnami repo at https://charts.bitnami.com/bitnami to Helm
 <details><summary>show</summary>
 <p>
 
 ```bash
-helm install -f myvalues.yaml myredis ./redis
+helm repo add bitnami https://charts.bitnami.com/bitnami
+```
+
+Show the list of installed repositories:
+```bash
+helm repo list
 ```
 
 </p>
 </details>
 
-### Find pending Helm deployments on all namespaces
+### Using Helm repo
 
 <details><summary>show</summary>
 <p>
 
+Add, list, remove, update and index chart repos
+
 ```bash
-helm list --pending -A
+helm repo add [NAME] [URL] [flags]
+
+helm repo list / helm repo ls
+
+helm repo remove [REPO1] [flags]
+
+helm repo update / helm repo up
+
+helm repo update [REPO1] [flags]
+
+helm repo index [DIR] [flags]
 ```
 
 </p>
 </details>
 
-### Uninstall a Helm release
-
+### Search Repositories for a Chart
 <details><summary>show</summary>
 <p>
 
+Search all installed repositories for a chart
+
 ```bash
-helm uninstall -n namespace release_name
+helm search repo [keyword]
 ```
 
 </p>
 </details>
 
-### Upgrading a Helm chart
+### Download a Helm chart from a repository
 
 <details><summary>show</summary>
 <p>
 
 ```bash
-helm upgrade -f myvalues.yaml -f override.yaml redis ./redis
+helm pull [chart URL | repo/chartname] [...] [flags] ## this would download a chart, but not install it
+helm pull --untar [repo/chartname] # untar the chart after downloading it (does not create a release)
 ```
 
 </p>
 </details>
 
-### Using Helm repo
+### Create a Release
 
 <details><summary>show</summary>
 <p>
 
-Add, list, remove, update and index chart repos
+Create a release, creating the resources defined in the chart
 
 ```bash
-helm repo add [NAME] [URL]  [flags]
-
-helm repo list / helm repo ls
+helm install -f myvalues.yaml myredis ./redis # creates a release from a local chart
+helm install [releasename] [repo/chartname] # creates a release from a chart in a repo
+# Example: helm install my-app bitnami/nginx
+```
 
-helm repo remove [REPO1] [flags]
+</p>
+</details>
 
-helm repo update / helm repo up
+### Find pending Helm deployments on all namespaces
 
-helm repo update [REPO1] [flags]
+<details><summary>show</summary>
+<p>
 
-helm repo index [DIR] [flags]
+```bash
+helm list --pending -A
 ```
 
 </p>
 </details>
 
-### Download a Helm chart from a repository 
+### Uninstall a Helm release
 
 <details><summary>show</summary>
 <p>
 
 ```bash
-helm pull [chart URL | repo/chartname] [...] [flags] ## this would download a helm, not install 
-helm pull --untar [rep/chartname] # untar the chart after downloading it 
+helm uninstall -n namespace releasename
 ```
 
 </p>
 </details>
 
-### Add the Bitnami repo at https://charts.bitnami.com/bitnami to Helm
+### Upgrading a Helm chart
+
 <details><summary>show</summary>
 <p>
-    
+
 ```bash
-helm repo add bitnami https://charts.bitnami.com/bitnami
+helm upgrade [releasename] [repo/chartname] # Upgrade a chart from a repository
+helm upgrade -f myvalues.yaml -f override.yaml redis ./redis # Upgrade a local chart from a file
 ```
-  
+
 </p>
 </details>
 
-### Write the contents of the values.yaml file of the `bitnami/node` chart to standard output
+### Write the contents of the values.yaml of a chart to standard output
 <details><summary>show</summary>
 <p>
-    
+
 ```bash
-helm show values bitnami/node
+helm show values [repo/chartname]
 ```
-  
+
 </p>
 </details>
 
@@ -140,7 +163,7 @@ which returns
 ## @param replicaCount Specify the number of replicas for the application
 replicaCount: 1
 ```
- 
+
 We can use the `--set` argument during installation to override attribute values. Hence, to set the replica count to 5, we need to run
 ```bash
 helm install mynode bitnami/node --set replicaCount=5