diff --git a/hadoop-yarn-project/CHANGES.txt b/hadoop-yarn-project/CHANGES.txt
index dd875828560..1dfa87eee2b 100644
--- a/hadoop-yarn-project/CHANGES.txt
+++ b/hadoop-yarn-project/CHANGES.txt
@@ -191,6 +191,9 @@ Release 2.4.0 - UNRELEASED
available across RM failover by making using of a remote
configuration-provider. (Xuan Gong via vinodkv)
+ YARN-1171. Add default queue properties to Fair Scheduler documentation
+ (Naren Koneru via Sandy Ryza)
+
OPTIMIZATIONS
BUG FIXES
diff --git a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm
index 97436fb8e54..32bb0b80dda 100644
--- a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm
+++ b/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".