diff --git hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm
index 97436fb..32bb0b8 100644
--- hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm
+++ hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm
@@ -265,7 +265,15 @@ Allocation file format
its fair share before it will try to preempt containers to take resources from
other queues.
- * <>, which sets the default scheduling
+ * <>, which sets the default number
+ of seconds the queue is under its minimum share before it will try to preempt
+ containers to take resources from other queues; overriden by
+ minSharePreemptionTimeout element in each queue if specified.
+
+ * <>, which sets the default running app limit
+ for queues; overriden by maxRunningApps element in each queue.
+
+ * <>, which sets the default scheduling
policy for queues; overriden by the schedulingPolicy element in each queue
if specified. Defaults to "fair".