fixup: improve page on configuring storage sizes

Signed-off-by: Andrew Obuchowicz <[email protected]>

modules/administration-guide/pages/configuring-storage-sizes.adoc

@@ -7,7 +7,7 @@
 [id="configuring-storage-sizes"]
 = Configuring storage sizes
 
-You can configure the persistent volume claim (PVC) size when using the `per-user` or `per-workspace` storage strategies. You must specify the PVC sizes in the `CheCluster` Custom Resource in the format of a link:https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/[{kubernetes} resource quantity]. For more details on the available storage strategies, see xref:configuring-che-storage-strategy.adoc[].
+You can configure the persistent volume claim (PVC) size when using the `per-user` or `per-workspace` storage strategies. You must specify the PVC sizes in the `CheCluster` Custom Resource in the format of a link:https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/[{kubernetes} resource quantity]. For more details on the available storage strategies, see xref:configuring-the-storage-strategy.adoc[].
 
 Default persistent volume claim sizes:
 
@@ -28,7 +28,7 @@ per-workspace: 5Gi
 
 .Procedure
 
-Set the appropriate `claimSize` field for the desired storage strategy in the Che Cluster Custom Resource.
+. Set the appropriate `claimSize` field for the desired storage strategy in the Che Cluster Custom Resource.
 
 [NOTE]
 ====
@@ -47,10 +47,10 @@ spec:
       pvc:
         pvcStrategy: '__<strategy_name>__'  <1>
         perUserStrategyPvcConfig: <2>
-          claimSize: __<size_number>__Gi
-        perWorkspaceStrategyPvcConfig:  <3>
-          claimSize: __<size_number>__Gi
+          claimSize: __<resource_quantity>__ <3>
+        perWorkspaceStrategyPvcConfig:  <2>
+          claimSize: __<resource_quantity>__ <3>
 ----
-<1> Select the storage strategy: `per-user` or * `per-workspace` or `ephemeral`. Note: the `ephemeral` storage strategy does not use persistent storage, therefore you cannot configure its storage size or other PVC-related attributes. 
+<1> Select the storage strategy: `per-user` or `per-workspace` or `ephemeral`. Note: the `ephemeral` storage strategy does not use persistent storage, therefore you cannot configure its storage size or other PVC-related attributes. 
 <2> Specify a claim size on the next line or omit the next line to set the default claim size value. The specified claim size is only used when you select this storage strategy.
-<3> Specify a claim size on the next line or omit the next line to set the default claim size value. The specified claim size is only used when you select this storage strategy.
+<3> The claim size must be specified as a link:https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/[{kubernetes} resource quantity]. The available quantity units include: `Ei`, `Pi`, `Ti`, `Gi`,  `Mi` and `Ki`.