From d1d634f78bd80530b5289dbfd307f796896914eb Mon Sep 17 00:00:00 2001
From: Mark O Brien <markobri@redhat.com>
Date: Wed, 15 Jun 2022 14:06:36 +0100
Subject: [PATCH] refactor communishift docs

Signed-off-by: Mark O Brien <markobri@redhat.com>
---
 docs/communishift/resource-quota.rst | 72 ++++++++++++++--------------
 1 file changed, 35 insertions(+), 37 deletions(-)

diff --git a/docs/communishift/resource-quota.rst b/docs/communishift/resource-quota.rst
index c598ace..7e18f73 100644
--- a/docs/communishift/resource-quota.rst
+++ b/docs/communishift/resource-quota.rst
@@ -21,44 +21,42 @@ that gets created (properly tagged) for community users.
 
 Limits can go from storage, memory and cpu usage to the amount of objects (limit the namespace to have a max. of 5 secrets for example).
 
-Sample object definition:
+Sample object definition::
 
-.. codeblock:: python
-
-    apiVersion: v1
-    kind: ResourceQuota
-    metadata:
-      name: app-quota
-    spec:
-      hard:
-        # compute
-        cpu: "1" # requests.cpu
-        memory: "1Gi" # requests.memory
-        ephemeral-storage: "10Gi" # requests.ephemeral-storage
-        limits.cpu: "2"
-        limits.memory: "2Gi"
-        limits.ephemeral-storage: "10Gi"
-        # storage
-        requests.storage: "10Gi"
-        persistentvolumeclaims: "1"
-        # <storage-class-name>.storageclass.storage.k8s.io/requests.storage
-        # <storage-class-name>.storageclass.storage.k8s.io/persistentvolumeclaims
-        # object counts
-        pods: "1"
-        replicationcontrollers: 1
-        # resourcequotas: 1
-        # services: 1
-        # services.loadbalancers: 1
-        # services.nodeports: 1
-        # secrets: 1
-        # configmaps: 1
-        # openshift.io/imagestreams: 1
-      # scopes:
-        # https://docs.openshift.com/container-platform/4.6/applications/quotas/quotas-setting-per-project.html#quotas-scopes_quotas-setting-per-project
-        # - Terminating
-        # - NotTerminating
-        # - BestEffort
-        # - NotBestEffort
+  apiVersion: v1
+  kind: ResourceQuota
+  metadata:
+    name: app-quota
+  spec:
+    hard:
+      # compute
+      cpu: "1" # requests.cpu
+      memory: "1Gi" # requests.memory
+      ephemeral-storage: "10Gi" # requests.ephemeral-storage
+      limits.cpu: "2"
+      limits.memory: "2Gi"
+      limits.ephemeral-storage: "10Gi"
+      # storage
+      requests.storage: "10Gi"
+      persistentvolumeclaims: "1"
+      # <storage-class-name>.storageclass.storage.k8s.io/requests.storage
+      # <storage-class-name>.storageclass.storage.k8s.io/persistentvolumeclaims
+      # object counts
+      pods: "1"
+      replicationcontrollers: 1
+      # resourcequotas: 1
+      # services: 1
+      # services.loadbalancers: 1
+      # services.nodeports: 1
+      # secrets: 1
+      # configmaps: 1
+      # openshift.io/imagestreams: 1
+    # scopes:
+      # https://docs.openshift.com/container-platform/4.6/applications/quotas/quotas-setting-per-project.html#quotas-scopes_quotas-setting-per-project
+      # - Terminating
+      # - NotTerminating
+      # - BestEffort
+      # - NotBestEffort
 
 Conclusion
 ----------