fixed typos and made hrq doc more clear

Signed-off-by: unknown <[email protected]>

Author: zfrhv

docs/user-guide/concepts.md

@@ -13,7 +13,7 @@ namespaces are, and _why_ they behave the way they do.
 * [Basic concepts](#basic)
   * [Parents, children, trees and forests](#basic-trees)
   * [Full namespaces and subnamespaces](#basic-subns)
-  * [Hierarchical Resource Quotas](#hierarchical-resource-quota)
+  * [Hierarchical resource quotas (HRQs)](#hrq)
   * [Policy inheritance and object propagation](#basic-propagation)
   * [Tree labels and non-propagated policies](#basic-labels)
   * [Exceptions and propagation control](#basic-exceptions)
@@ -221,21 +221,21 @@ probably not a great idea.
 You can create a subnamespace from the command line via `kubectl hns create child
 -n parent`.
 
-<a name="hierarchical-resource-quota">
+<a name="hrq">
 
-### Hierarchical Resource Quotas
+### Hierarchical resource quotas (HRQs)
 
 When you want to give some amount of resources to `team-a`, and want them to be able
-to distrtibute their resources between themselves, you create a HierarchicalResourceQuota
-in namespace `team-a`. any member from `team-a` can create his own HierarchicalResourceQuota
-in his subnamespace, and the sum of all reasources from all the subnamespaces of the
+to distrtibute their resources between themselves, you create a `HierarchicalResourceQuota`
+in namespace `team-a`. Any member from `team-a` can create their own `HierarchicalResourceQuota`
+in his subnamespace, and the sum of all resources from all the subnamespaces of the
 members wont be over the amount of resources that is configured in
-HierarchicalResourceQuota of namespace `team-a`.
+`HierarchicalResourceQuota` of namespace `team-a`.
 
-when creating HierarchicalResourceQuota, HNC automatically creates ResourceQuota
+when creating `HierarchicalResourceQuota`, HNC automatically creates `ResourceQuota`
 with name `local-impl-hrq` and propogates it to all subnamespaces. It monitors
-the ResourceQuotas in the namespace tree, and sums up their usage. If there are multiple 
-HRQs in the tree, the local ResourceQuota will have the combined results of all HRQs
+the `ResourceQuotas` in the namespace tree, and sums up their usage. If there are multiple 
+HRQs in the tree, the local `ResourceQuota` will have the combined results of all HRQs
 from the parent namespaces.
 
 

docs/user-guide/how-to.md

@@ -191,11 +191,13 @@ destination (descendant) namespace.
 
 ### Limit Resources over parent namespaces
 
-HNC has an object called HirarchicalResourceQuota that is similar to ResourceQuota
-but across all namespace tree. It allows you to distribute tour resources between
+HNC has an object called `HirarchicalResourceQuota` that is similar to `ResourceQuota`
+but across all the namespaces in a hierarchy. It allows you to distribute your resources between
 teams, and those teams can distribute their resources between their subteams...
 [learn how it works](concepts.md#hierarchical-resource-quota) or see an [quickstart example](quickstart.md#hrq)
 
+Note: decimal point values cannot be specified in HRQ (you can't do `cpu: 1.5`). see [#292](https://github.com/kubernetes-sigs/hierarchical-namespaces/issues/292)
+
 <a name="use-select"/>
 
 ### Select namespaces based on their hierarchies

docs/user-guide/quickstart.md

@@ -472,7 +472,7 @@ acme-org
 └── [s] team-b
 ```
 
-You can create a HierarchicalResourceQuota in namespace `acme-org`, and the sum of 
+You can create a `HierarchicalResourceQuota` in namespace `acme-org`, and the sum of 
 all subnamespaces resource usage cant go over what is configured in the hrq.
 
 Creating the hrq:
@@ -530,14 +530,18 @@ EOF
 ```
 We get an error:
 ```
-Error from server (Forbidden): error when creating "STDIN": admission webhood "resourcesquotasstatus.hnc.x-k8s.io" denied the request: exceeded hierarchical quota in namespace "acme-org": "acme-org-hrq", requested: services=1, used: services=1, limited: services=1
+Error from server (Forbidden):
+  error when creating "STDIN":
+    admission webhood "resourcesquotasstatus.hnc.x-k8s.io" denied the request:
+      exceeded hierarchical quota in namespace "acme-org":
+        "acme-org-hrq", requested: services=1, used: services=1, limited: services=1
 ```
 
-to view the hrq usage simply run
+To view the HRQ usage, simply run:
 ```bash
 kubectl hns hrq -n acme-org
 ```
-you can also biew in all namespace
+you can also view in all namespace:
 ```bash
 kubectl hns hrq --all-namespaces
 ```
@@ -547,6 +551,8 @@ and you can delete the hrq via simply deleting the CR:
 kubectl delete hrq acme-org-hrq -n acme-org
 ```
 
+Note: decimal point values cannot be specified (you can't do `cpu: 1.5`). see [#292](https://github.com/kubernetes-sigs/hierarchical-namespaces/issues/292)
+
 <a name="subns"/>
 
 ### Subnamespaces deep dive