diff --git a/lib/elements/dom-repeat.html b/lib/elements/dom-repeat.html
index bd6459498d..78d71d9281 100644
--- a/lib/elements/dom-repeat.html
+++ b/lib/elements/dom-repeat.html
@@ -254,12 +254,12 @@
* fps) to target by throttling the number of instances rendered each
* frame to not exceed the budget for the target frame rate. The
* framerate is effectively the number of `requestAnimationFrame`s that
- * it tries to allow to actually fire in a given second, and it targets
- * this by empirically measuring the time between rAF's and throttling
- * up/down the number of items created each `rAF`. Setting this to a
- * higher number will allow lower latency and higher throughput for
- * event handlers and other tasks, but will result in a longer time for
- * the remaining items to complete rendering.
+ * it tries to allow to actually fire in a given second. It does this
+ * by measuring the time between `rAF`s and continuously adjusting the
+ * number of items created each `rAF` to maintain the target framerate.
+ * Setting this to a higher number allows lower latency and higher
+ * throughput for event handlers and other tasks, but results in a
+ * longer time for the remaining items to complete rendering.
*/
targetFramerate: {
type: Number,