diff --git a/src/ol.jsdoc b/src/ol.jsdoc
index 47c6db565c..2c1bf53836 100644
--- a/src/ol.jsdoc
+++ b/src/ol.jsdoc
@@ -1,3 +1,4 @@
 /**
  * @namespace ol
  */
+
diff --git a/src/ol/View.js b/src/ol/View.js
index 82af07c54a..e6e631d24b 100644
--- a/src/ol/View.js
+++ b/src/ol/View.js
@@ -24,7 +24,8 @@ import Units from './proj/Units.js';
 
 
 /**
- * @type {number} Default min zoom level for the map view.
+ * Default min zoom level for the map view.
+ * @type {number}
  */
 const DEFAULT_MIN_ZOOM = 0;
 
diff --git a/src/ol/control/OverviewMap.js b/src/ol/control/OverviewMap.js
index 7390d01fa0..9badaa2c65 100644
--- a/src/ol/control/OverviewMap.js
+++ b/src/ol/control/OverviewMap.js
@@ -21,15 +21,17 @@ import {containsExtent, getBottomLeft, getBottomRight, getTopLeft, getTopRight,
 
 
 /**
- * @type {number} Maximum width and/or height extent ratio that determines
- * when the overview map should be zoomed out.
+ * Maximum width and/or height extent ratio that determines when the overview
+ * map should be zoomed out.
+ * @type {number}
  */
 const MAX_RATIO = 0.75;
 
 
 /**
- * @type {number} Minimum width and/or height extent ratio that determines
- * when the overview map should be zoomed in.
+ * Minimum width and/or height extent ratio that determines when the overview
+ * map should be zoomed in.
+ * @type {number}
  */
 const MIN_RATIO = 0.1;
 
diff --git a/src/ol/index.js b/src/ol/index.js
index 05efbdbefd..7e4ca3f600 100644
--- a/src/ol/index.js
+++ b/src/ol/index.js
@@ -6,9 +6,10 @@ import webgl from './webgl.js';
 
 
 /**
+ * Include debuggable shader sources.  Default is `true`. This should be set to
+ * `false` for production builds.
  * TODO: move to a separate ol-webgl package
- * @type {boolean} Include debuggable shader sources.  Default is `true`.
- *     This should be set to `false` for production builds.
+ * @type {boolean}
  */
 export const DEBUG_WEBGL = true;
 
@@ -60,7 +61,8 @@ export {HAS_WEBGL, WEBGL_MAX_TEXTURE_SIZE, WEBGL_EXTENSIONS};
 
 
 /**
- * @type {string} OpenLayers version.
+ * OpenLayers version.
+ * @type {string}
  */
 export const VERSION = 'v4.6.4';
 
diff --git a/src/ol/interaction/MouseWheelZoom.js b/src/ol/interaction/MouseWheelZoom.js
index e023c41a9f..43f404f6b3 100644
--- a/src/ol/interaction/MouseWheelZoom.js
+++ b/src/ol/interaction/MouseWheelZoom.js
@@ -12,7 +12,8 @@ import {clamp} from '../math.js';
 
 
 /**
- * @type {number} Maximum mouse wheel delta.
+ * Maximum mouse wheel delta.
+ * @type {number}
  */
 const MAX_DELTA = 1;
 
diff --git a/src/ol/renderer/vector.js b/src/ol/renderer/vector.js
index 70a2d767ee..188889e506 100644
--- a/src/ol/renderer/vector.js
+++ b/src/ol/renderer/vector.js
@@ -9,7 +9,8 @@ const _ol_renderer_vector_ = {};
 
 
 /**
- * @type {number} Tolerance for geometry simplification in device pixels.
+ * Tolerance for geometry simplification in device pixels.
+ * @type {number}
  */
 const SIMPLIFY_TOLERANCE = 0.5;
 
diff --git a/src/ol/renderer/webgl/Map.js b/src/ol/renderer/webgl/Map.js
index 8fad0bdd18..561516f3f5 100644
--- a/src/ol/renderer/webgl/Map.js
+++ b/src/ol/renderer/webgl/Map.js
@@ -23,7 +23,8 @@ import ContextEventType from '../../webgl/ContextEventType.js';
 
 
 /**
- * @type {number} Texture cache high water mark.
+ * Texture cache high water mark.
+ * @type {number}
  */
 const WEBGL_TEXTURE_CACHE_HIGH_WATER_MARK = 1024;
 
diff --git a/src/ol/reproj/Triangulation.js b/src/ol/reproj/Triangulation.js
index 702c092c46..6216cd1689 100644
--- a/src/ol/reproj/Triangulation.js
+++ b/src/ol/reproj/Triangulation.js
@@ -8,23 +8,22 @@ import {getTransform} from '../proj.js';
 
 
 /**
- * @type {number} Maximum number of subdivision steps during raster
- *     reprojection triangulation. Prevents high memory usage and large
- *     number of proj4 calls (for certain transformations and areas).
- *     At most `2*(2^this)` triangles are created for each triangulated
- *     extent (tile/image).
+ * Maximum number of subdivision steps during raster reprojection triangulation.
+ * Prevents high memory usage and large number of proj4 calls (for certain
+ * transformations and areas). At most `2*(2^this)` triangles are created for
+ * each triangulated extent (tile/image).
+ * @type {number}
  */
 const MAX_SUBDIVISION = 10;
 
 
 /**
- * @type {number} Maximum allowed size of triangle relative to world width.
- *     When transforming corners of world extent between certain projections,
- *     the resulting triangulation seems to have zero error and no subdivision
- *     is performed.
- *     If the triangle width is more than this (relative to world width; 0-1),
- *     subdivison is forced (up to `MAX_SUBDIVISION`).
- *     Default is `0.25`.
+ * Maximum allowed size of triangle relative to world width. When transforming
+ * corners of world extent between certain projections, the resulting
+ * triangulation seems to have zero error and no subdivision is performed. If
+ * the triangle width is more than this (relative to world width; 0-1),
+ * subdivison is forced (up to `MAX_SUBDIVISION`). Default is `0.25`.
+ * @type {number}
  */
 const MAX_TRIANGLE_WIDTH = 0.25;
 
diff --git a/src/ol/reproj/common.js b/src/ol/reproj/common.js
index 6b28ebfe6b..f74827bfe0 100644
--- a/src/ol/reproj/common.js
+++ b/src/ol/reproj/common.js
@@ -1,12 +1,13 @@
 /**
- * @type {number} Default maximum allowed threshold  (in pixels) for
- *     reprojection triangulation.
+ * Default maximum allowed threshold  (in pixels) for reprojection
+ * triangulation.
+ * @type {number}
  */
 export const ERROR_THRESHOLD = 0.5;
 
 /**
+ * Enable automatic reprojection of raster sources. Default is `true`.
  * TODO: decide if we want to expose this as a build flag or remove it
- * @type {boolean} Enable automatic reprojection of raster sources. Default is
- *     `true`.
+ * @type {boolean}
  */
 export const ENABLE_RASTER_REPROJECTION = true;
diff --git a/src/ol/source/common.js b/src/ol/source/common.js
index 373726a379..9e3f04c681 100644
--- a/src/ol/source/common.js
+++ b/src/ol/source/common.js
@@ -1,4 +1,5 @@
 /**
- * @type {string} Default WMS version.
+ * Default WMS version.
+ * @type {string}
  */
 export const DEFAULT_WMS_VERSION = '1.3.0';
diff --git a/src/ol/style/AtlasManager.js b/src/ol/style/AtlasManager.js
index 8bd2b80b08..81df116720 100644
--- a/src/ol/style/AtlasManager.js
+++ b/src/ol/style/AtlasManager.js
@@ -6,12 +6,14 @@ import Atlas from '../style/Atlas.js';
 
 
 /**
- * @type {number} The size in pixels of the first atlas image.
+ * The size in pixels of the first atlas image.
+ * @type {number}
  */
 const INITIAL_ATLAS_SIZE = 256;
 
 /**
- * @type {number} The maximum size in pixels of atlas images.
+ * The maximum size in pixels of atlas images.
+ * @type {number}
  */
 const MAX_ATLAS_SIZE = -1;
 
diff --git a/src/ol/tilegrid/common.js b/src/ol/tilegrid/common.js
index b43e79676f..57a19b76ad 100644
--- a/src/ol/tilegrid/common.js
+++ b/src/ol/tilegrid/common.js
@@ -1,9 +1,11 @@
 /**
- * @type {number} Default maximum zoom for default tile grids.
+ * Default maximum zoom for default tile grids.
+ * @type {number}
  */
 export const DEFAULT_MAX_ZOOM = 42;
 
 /**
- * @type {number} Default tile size.
+ * Default tile size.
+ * @type {number}
  */
 export const DEFAULT_TILE_SIZE = 256;