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,