diff --git a/docs/infrastructure-mariadb.md b/docs/infrastructure-mariadb.md
index f45bf166..0f9bfbcb 100644
--- a/docs/infrastructure-mariadb.md
+++ b/docs/infrastructure-mariadb.md
@@ -15,7 +15,8 @@ kubectl --namespace openstack \
 If you've changed your k8s cluster name from the default cluster.local, edit `clusterName` in `/opt/genestack/kustomize/mariadb-operator/kustomization.yaml` prior to deploying the mariadb operator.
 
 ``` shell
-kubectl kustomize --enable-helm /opt/genestack/kustomize/mariadb-operator | kubectl --namespace mariadb-system apply --server-side --force-conflicts -f -
+kubectl kustomize --enable-helm /opt/genestack/kustomize/mariadb-operator | \
+  kubectl --namespace mariadb-system apply --server-side --force-conflicts -f -
 ```
 
 !!! info
diff --git a/docs/prometheus.md b/docs/prometheus.md
index de5973bf..d63b22da 100644
--- a/docs/prometheus.md
+++ b/docs/prometheus.md
@@ -1,12 +1,9 @@
 # Prometheus
 
-We are using Prometheus for monitoring and metrics collection backend.
-To read more about Prometheus see: https://prometheus.io
+We are using Prometheus for monitoring and metrics collection backend. To read more about Prometheus using the [upstream docs](https://prometheus.io).
 
 #### Install kube-prometheus helm chart
 
 ``` shell
-cd /opt/genestack/kustomize/prometheus
-
-kubectl kustomize --enable-helm . | kubectl create -f -
+kubectl kustomize --enable-helm /opt/genestack/kustomize/prometheus | kubectl apply --server-side -f -
 ```