diff --git a/src/ol/feature.js b/src/ol/feature.js
index e95dd202ac..99cedb8fab 100644
--- a/src/ol/feature.js
+++ b/src/ol/feature.js
@@ -21,6 +21,8 @@ goog.require('ol.style.Style');
  * attribute properties, similar to the features in vector file formats like
  * GeoJSON.
  * Features can be styled individually or use the style of their vector layer.
+ * Note that attribute properties are set as {@link ol.Object} properties on the
+ * feature object, so they are observable, and have get/set accessors.
  *
  * @constructor
  * @extends {ol.Object}
diff --git a/src/ol/layer/heatmaplayer.js b/src/ol/layer/heatmaplayer.js
index a3a1e8be1a..df3309b8a5 100644
--- a/src/ol/layer/heatmaplayer.js
+++ b/src/ol/layer/heatmaplayer.js
@@ -23,6 +23,9 @@ ol.layer.HeatmapLayerProperty = {
 /**
  * @classdesc
  * Layer for rendering vector data as a heatmap.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Vector}
diff --git a/src/ol/layer/imagelayer.js b/src/ol/layer/imagelayer.js
index 253492c437..49d85396cb 100644
--- a/src/ol/layer/imagelayer.js
+++ b/src/ol/layer/imagelayer.js
@@ -8,6 +8,9 @@ goog.require('ol.layer.Layer');
  * @classdesc
  * Server-rendered images that are available for arbitrary extents and
  * resolutions.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Layer}
diff --git a/src/ol/layer/layerbase.js b/src/ol/layer/layerbase.js
index f043923b0e..f2c9c1b6b6 100644
--- a/src/ol/layer/layerbase.js
+++ b/src/ol/layer/layerbase.js
@@ -44,6 +44,9 @@ ol.layer.LayerState;
  * @classdesc
  * Abstract base class; normally only used for creating subclasses and not
  * instantiated in apps.
+ * Note that with `ol.layer.Base` and all its subclasses, any property set in
+ * the options is set as a {@link ol.Object} property on the layer object, so
+ * is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.Object}
diff --git a/src/ol/layer/tilelayer.js b/src/ol/layer/tilelayer.js
index a0cbc8c7a0..133e37b436 100644
--- a/src/ol/layer/tilelayer.js
+++ b/src/ol/layer/tilelayer.js
@@ -17,6 +17,9 @@ ol.layer.TileProperty = {
  * @classdesc
  * For layer sources that provide pre-rendered, tiled images in grids that are
  * organized by zoom levels for specific resolutions.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Layer}
diff --git a/src/ol/layer/vectorlayer.js b/src/ol/layer/vectorlayer.js
index a2a3615060..90aae8bc6d 100644
--- a/src/ol/layer/vectorlayer.js
+++ b/src/ol/layer/vectorlayer.js
@@ -17,6 +17,9 @@ ol.layer.VectorProperty = {
 /**
  * @classdesc
  * Vector data that is rendered client-side.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Layer}