{subsubsection: Meaning of quota for "static" quota:}
-The static quota for a given group indicates the minimum number of machine that group is expected to be allocated, given
+The static quota for a given group indicates the minimum number of machines/slots that group is expected to be allocated, given
sufficient demand. The sum of the static quota for all the children nodes of any given parent must be less than or equal to the parent's static quota.
-The sum of the children's static quota may be less than the parent. If so, the extra will be apportioned only to the immediate children (?),
-regardless of setting of accept_surplus (?), and autoregroup -- proportioned how? proportionally to demand? user_prio?
+
+The sum of the children's static quota may be less than the parent. If so, the remainder is assigned to the parent.
{subsubsection: For dynamic (proportional) quota}
A dynamic (proportional) quota indicates the percentage of the parent's node resources the group is expected to be allocated,
-given sufficient demand. If the children of a node have proportional quota, each node then is assigned an absolute quota based on the proportion assigned to their
-parent's node. The sum of all the sibling quota should be < 1.0.
+given sufficient demand. If the children of a node have proportional quota, each node then is assigned an absolute quota based on the proportion assigned to their parent's node.
+
+The sum of all the sibling quota should be <= 1.0. (if not, they are normalized to 1 with a warning message)
+
+{subsubsection: specifying quotas}
Each job then specifies what group it should be in with the "+AccountingGroup = "group_name.username" syntax.
+{subsubsection: quota terminology}
Note: The term "quota" is overloaded. Sometimes in the code and documentation, it means "the amount assigned by the
-administrator to a group". Other times, it means "The amount assigned by the administrator, added to the leftover slots
-from other groups".
+administrator to a group" (entry->config_quota). It may also be the value translated from configured quota to actual (possibly weighted) slot quantity (entry->quota). The quantity finally assigned to a group, after quota computation and surplus sharing and fractional-quota distribution, is referred to as 'allocated' (entry->allocated).
{subsection: Algorithm}
