Additional tests, documentation and example

src/ol/layer/vectortilelayer.js

@@ -16,7 +16,7 @@ ol.layer.VectorTileProperty = {
 
 /**
  * @classdesc
- * Vector tile data that is rendered client-side.
+ * Layer for vector tile 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.

src/ol/render/renderfeature.js

@@ -10,7 +10,7 @@ goog.require('ol.geom.GeometryType');
 
 /**
  * Lightweight, read-only, {@link ol.Feature} and {@link ol.geom.Geometry} like
- * structure, optimized for rendering and styling. Geometry acces through the
+ * structure, optimized for rendering and styling. Geometry access through the
  * API is limited to getting the type and extent of the geometry.
  *
  * @constructor

src/ol/source/vectorsource.js

@@ -66,7 +66,9 @@ ol.source.VectorEventType = {
 
 /**
  * @classdesc
- * Provides a source of features for vector layers.
+ * Provides a source of features for vector layers. Vector features provided
+ * by this source are suitable for editing. See {@link ol.source.VectorTile} for
+ * vector data that is optimized for rendering.
  *
  * @constructor
  * @extends {ol.source.Source}

src/ol/source/vectortilesource.js

@@ -12,7 +12,13 @@ goog.require('ol.source.UrlTile');
 
 /**
  * @classdesc
- * Base class for sources providing images divided into a tile grid.
+ * Class for layer sources providing vector data divided into a tile grid, to be
+ * used with {@link ol.layer.VectorTile}. Although this source receives tiles
+ * with vector features from the server, it is not meant for feature editing.
+ * Features are optimized for rendering, their geometries are clipped at or near
+ * tile boundaries and simplified for a view resolution. See
+ * {@link ol.source.Vector} for vector sources that are suitable for feature
+ * editing.
  *
  * @constructor
  * @fires ol.source.TileEvent