diff --git a/src/objectliterals.jsdoc b/src/objectliterals.jsdoc
index ccb0219162..1963f7c7d5 100644
--- a/src/objectliterals.jsdoc
+++ b/src/objectliterals.jsdoc
@@ -596,7 +596,8 @@
  * @property {number|undefined} blur Blur size in pixels. Default is `15`.
  * @property {number|undefined} shadow Shadow size in pixels. Default is `250`.
  * @property {string|function(ol.Feature):number|undefined} weight The feature attribute to use for the
- *     weight or a function that returns a weight from a feature. Default is `weight`.
+ *     weight or a function that returns a weight from a feature. Weight values should range from 0 to 1
+ *     (and values outside will be clamped to that range). Default is `weight`.
  * @property {number|undefined} minResolution The minimum resolution
  *      (inclusive) at which this layer will be visible.
  * @property {number|undefined} maxResolution The maximum resolution