update readme

README.adoc

@@ -22,22 +22,31 @@ Add Helm repository
 
 [source]
 ----
-$ helm repo add opal https://authorizon.github.io/opal-helm-chart
-$ helm repo update
+helm repo add opal https://authorizon.github.io/opal-helm-chart
+----
+
+[source]
+----
+helm repo update
 ----
 
 Install the latest version
 
 [source]
 ----
-$ helm install --create-namespace -n opal-ns myopal opal/opal
+helm install --create-namespace -n opal-ns myopal opal/opal
 ----
 
 Search for all available versions
 
 [source]
 ----
-$ helm search repo opal --versions
+helm search repo opal --versions
+----
+
+Will output:
+[source]
+----
 NAME                    CHART VERSION   APP VERSION     DESCRIPTION
 
 ... TO BE PROVIDED ....
@@ -48,18 +57,18 @@ Install specific version
 
 [source]
 ----
-$ helm install --create-namespace -n opal-ns --version x.x.x myopal opal/opal
+helm install --create-namespace -n opal-ns --version x.x.x myopal opal/opal
 ----
 
 === Verify installation
 
 OPAL Client should populate embedded OPA instance with polices and data from configured Git repository.
-To validate it - one could create port-forwarding to OPAL client Pod.
+To validate it - one could create port-forwarding to OPAL client Pod. Port 8181 is the embedded OPA agent.
 
 [source]
 ----
-$ kubectl port-forward -n opal-ns service/opal-client 8181:8181
+kubectl port-forward -n opal-ns service/opal-client 8181:8181
 ----
 
-Then, open http://localhost:8181/v1/data/ in your browser.
+Then, open http://localhost:8181/v1/data/ in your browser to check OPA data document state.