diff --git a/packages/turf-bezier/README.md b/packages/turf-bezier/README.md
index 2a71fc8533..83964f3e30 100644
--- a/packages/turf-bezier/README.md
+++ b/packages/turf-bezier/README.md
@@ -17,23 +17,14 @@ The bezier spline implementation is by [Leszek Rybicki](http://leszek.rybicki.cc
 **Examples**
 
 ```javascript
-var line = {
-  "type": "Feature",
-  "properties": {
-    "stroke": "#f00"
-  },
-  "geometry": {
-    "type": "LineString",
-    "coordinates": [
-      [-76.091308, 18.427501],
-      [-76.695556, 18.729501],
-      [-76.552734, 19.40443],
-      [-74.61914, 19.134789],
-      [-73.652343, 20.07657],
-      [-73.157958, 20.210656]
-    ]
-  }
-};
+var line = turf.lineString([
+    [-76.091308, 18.427501],
+    [-76.695556, 18.729501],
+    [-76.552734, 19.40443],
+    [-74.61914, 19.134789],
+    [-73.652343, 20.07657],
+    [-73.157958, 20.210656]
+]);
 
 var curved = turf.bezier(line);
 
diff --git a/packages/turf-bezier/index.js b/packages/turf-bezier/index.js
index 6a561f542f..ac605117e2 100644
--- a/packages/turf-bezier/index.js
+++ b/packages/turf-bezier/index.js
@@ -14,23 +14,14 @@ var Spline = require('./spline.js');
  * @param {number} [sharpness=0.85] a measure of how curvy the path should be between splines
  * @returns {Feature<LineString>} curved line
  * @example
- * var line = {
- *   "type": "Feature",
- *   "properties": {
- *     "stroke": "#f00"
- *   },
- *   "geometry": {
- *     "type": "LineString",
- *     "coordinates": [
- *       [-76.091308, 18.427501],
- *       [-76.695556, 18.729501],
- *       [-76.552734, 19.40443],
- *       [-74.61914, 19.134789],
- *       [-73.652343, 20.07657],
- *       [-73.157958, 20.210656]
- *     ]
- *   }
- * };
+ * var line = turf.lineString([
+ *     [-76.091308, 18.427501],
+ *     [-76.695556, 18.729501],
+ *     [-76.552734, 19.40443],
+ *     [-74.61914, 19.134789],
+ *     [-73.652343, 20.07657],
+ *     [-73.157958, 20.210656]
+ * ]);
  *
  * var curved = turf.bezier(line);
  *
diff --git a/packages/turf-boolean-clockwise/README.md b/packages/turf-boolean-clockwise/README.md
index f53e2e4abf..b0aafe9aec 100755
--- a/packages/turf-boolean-clockwise/README.md
+++ b/packages/turf-boolean-clockwise/README.md
@@ -11,8 +11,8 @@ Takes a ring and return true or false whether or not the ring is clockwise or co
 **Examples**
 
 ```javascript
-var clockwiseRing = [[0,0],[1,1],[1,0],[0,0]]
-var counterClockwiseRing = [[0,0],[1,0],[1,1],[0,0]]
+var clockwiseRing = turf.lineString([[0,0],[1,1],[1,0],[0,0]]);
+var counterClockwiseRing = turf.lineString([[0,0],[1,0],[1,1],[0,0]]);
 
 turf.booleanClockwise(clockwiseRing)
 //=true
diff --git a/packages/turf-boolean-clockwise/index.js b/packages/turf-boolean-clockwise/index.js
index 089d10757c..def2b79d63 100755
--- a/packages/turf-boolean-clockwise/index.js
+++ b/packages/turf-boolean-clockwise/index.js
@@ -8,8 +8,8 @@ var getCoords = invariant.getCoords;
  * @param {Geometry|Feature<LineString>|Array<Array<number>>} line to be evaluated
  * @returns {Boolean} true/false
  * @example
- * var clockwiseRing = [[0,0],[1,1],[1,0],[0,0]]
- * var counterClockwiseRing = [[0,0],[1,0],[1,1],[0,0]]
+ * var clockwiseRing = turf.lineString([[0,0],[1,1],[1,0],[0,0]]);
+ * var counterClockwiseRing = turf.lineString([[0,0],[1,0],[1,1],[0,0]]);
  *
  * turf.booleanClockwise(clockwiseRing)
  * //=true
diff --git a/packages/turf-boolean-contains/README.md b/packages/turf-boolean-contains/README.md
index e9a3468a2d..f568bf6297 100644
--- a/packages/turf-boolean-contains/README.md
+++ b/packages/turf-boolean-contains/README.md
@@ -15,22 +15,9 @@ Boolean-contains returns the exact opposite result of the `@turf/boolean-within`
 **Examples**
 
 ```javascript
-const point = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [1, 2]
-  }
-}
-const line = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "LineString",
-    "coordinates": [[1, 1], [1, 2], [1, 3], [1, 4]]
-  }
-}
+const line = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+const point = turf.point([1, 2]);
+
 turf.booleanContains(line, point);
 //=true
 ```
diff --git a/packages/turf-boolean-contains/index.js b/packages/turf-boolean-contains/index.js
index 3994ee98e6..87ab81b30a 100644
--- a/packages/turf-boolean-contains/index.js
+++ b/packages/turf-boolean-contains/index.js
@@ -16,22 +16,9 @@ var getGeomType = invariant.getGeomType;
  * @param {Geometry|Feature<any>} feature2 GeoJSON Feature or Geometry
  * @returns {Boolean} true/false
  * @example
- * const point = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [1, 2]
- *   }
- * }
- * const line = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "LineString",
- *     "coordinates": [[1, 1], [1, 2], [1, 3], [1, 4]]
- *   }
- * }
+ * const line = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+ * const point = turf.point([1, 2]);
+ *
  * turf.booleanContains(line, point);
  * //=true
  */
diff --git a/packages/turf-boolean-crosses/README.md b/packages/turf-boolean-crosses/README.md
index ba751f6064..3ea999fbc8 100644
--- a/packages/turf-boolean-crosses/README.md
+++ b/packages/turf-boolean-crosses/README.md
@@ -16,10 +16,14 @@ Boolean-Crosses returns t (TRUE) for only multipoint/polygon, multipoint/linestr
 **Examples**
 
 ```javascript
-var cross = turf.booleanCrosses(feature1, feature2);
+var line1 = turf.lineString([[-2, 2], [4, 2]]);
+var line2 = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+
+var cross = turf.booleanCrosses(line1, line2);
+//=true
 ```
 
-Returns **[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true/false
+Returns **[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true/false
 
 <!-- This file is automatically generated. Please don't edit it directly:
 if you find an error, edit the source file (likely index.js), and re-run
diff --git a/packages/turf-boolean-crosses/index.js b/packages/turf-boolean-crosses/index.js
index 94823984d4..9fba1d8162 100644
--- a/packages/turf-boolean-crosses/index.js
+++ b/packages/turf-boolean-crosses/index.js
@@ -16,9 +16,13 @@ var getGeomType = invariant.getGeomType;
  * @name booleanCrosses
  * @param {Geometry|Feature<any>} feature1 GeoJSON Feature or Geometry
  * @param {Geometry|Feature<any>} feature2 GeoJSON Feature or Geometry
- * @returns {Boolean} true/false
+ * @returns {boolean} true/false
  * @example
- * var cross = turf.booleanCrosses(feature1, feature2);
+ * var line1 = turf.lineString([[-2, 2], [4, 2]]);
+ * var line2 = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+ *
+ * var cross = turf.booleanCrosses(line1, line2);
+ * //=true
  */
 
 module.exports = function (feature1, feature2) {
diff --git a/packages/turf-boolean-disjoint/README.md b/packages/turf-boolean-disjoint/README.md
index 06492271f6..921eb95319 100644
--- a/packages/turf-boolean-disjoint/README.md
+++ b/packages/turf-boolean-disjoint/README.md
@@ -12,22 +12,9 @@ Boolean-disjoint returns (TRUE) if the intersection of the two geometries is an
 **Examples**
 
 ```javascript
-const point = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [2, 2]
-  }
-}
-const line = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "LineString",
-    "coordinates": [[1, 1], [1, 2], [1, 3], [1, 4]]
-  }
-}
+const point = turf.point([2, 2]);
+const line = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+
 turf.booleanDisjoint(line, point);
 //=true
 ```
diff --git a/packages/turf-boolean-disjoint/index.js b/packages/turf-boolean-disjoint/index.js
index 5290ec2201..fff9e4d1ab 100644
--- a/packages/turf-boolean-disjoint/index.js
+++ b/packages/turf-boolean-disjoint/index.js
@@ -11,22 +11,9 @@ var polyToLinestring = require('@turf/polygon-to-linestring');
  * @param {Geometry|Feature<any>} feature2 GeoJSON Feature or Geometry
  * @returns {Boolean} true/false
  * @example
- * const point = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [2, 2]
- *   }
- * }
- * const line = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "LineString",
- *     "coordinates": [[1, 1], [1, 2], [1, 3], [1, 4]]
- *   }
- * }
+ * const point = turf.point([2, 2]);
+ * const line = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);
+ *
  * turf.booleanDisjoint(line, point);
  * //=true
  */
diff --git a/packages/turf-boolean-point-on-line/README.md b/packages/turf-boolean-point-on-line/README.md
index 5037d4598f..a9f1076ff1 100644
--- a/packages/turf-boolean-point-on-line/README.md
+++ b/packages/turf-boolean-point-on-line/README.md
@@ -8,7 +8,7 @@ Returns true if a point is on a line. Accepts a optional parameter to ignore the
 
 -   `point` **([Geometry](http://geojson.org/geojson-spec.html#geometry) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>)** GeoJSON Feature or Geometry
 -   `linestring` **([Geometry](http://geojson.org/geojson-spec.html#geometry) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[LineString](http://geojson.org/geojson-spec.html#linestring)>)** GeoJSON Feature or Geometry
--   `ignoreEndVertices` **\[[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** whether to ignore the start and end vertices. (optional, default `false`)
+-   `ignoreEndVertices` **\[[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** whether to ignore the start and end vertices. (optional, default `false`)
 
 **Examples**
 
@@ -19,7 +19,7 @@ var isPointOnLine = turf.booleanPointOnLine(pt, line);
 //=true
 ```
 
-Returns **[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true/false
+Returns **[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** true/false
 
 <!-- This file is automatically generated. Please don't edit it directly:
 if you find an error, edit the source file (likely index.js), and re-run
diff --git a/packages/turf-center/README.md b/packages/turf-center/README.md
index 94b6e7bae2..2c81b65421 100644
--- a/packages/turf-center/README.md
+++ b/packages/turf-center/README.md
@@ -12,33 +12,11 @@ Takes a [Feature](http://geojson.org/geojson-spec.html#feature-objects) or [Feat
 **Examples**
 
 ```javascript
-var features = {
-  "type": "FeatureCollection",
-  "features": [
-    {
-      "type": "Feature",
-      "properties": {},
-      "geometry": {
-        "type": "Point",
-        "coordinates": [-97.522259, 35.4691]
-      }
-    }, {
-      "type": "Feature",
-      "properties": {},
-      "geometry": {
-        "type": "Point",
-        "coordinates": [-97.502754, 35.463455]
-      }
-    }, {
-      "type": "Feature",
-      "properties": {},
-      "geometry": {
-        "type": "Point",
-        "coordinates": [-97.508269, 35.463245]
-      }
-    }
-  ]
-};
+var features = turf.featureCollection([
+    turf.point([-97.522259, 35.4691]),
+    turf.point([-97.502754, 35.463455]),
+    turf.point([-97.508269, 35.463245])
+]);
 
 var center = turf.center(features);
 
diff --git a/packages/turf-center/index.js b/packages/turf-center/index.js
index 18fc825dd0..d778ad043e 100644
--- a/packages/turf-center/index.js
+++ b/packages/turf-center/index.js
@@ -9,33 +9,11 @@ var point = require('@turf/helpers').point;
  * @param {Object} [properties] an Object that is used as the {@link Feature}'s properties
  * @returns {Feature<Point>} a Point feature at the absolute center point of all input features
  * @example
- * var features = {
- *   "type": "FeatureCollection",
- *   "features": [
- *     {
- *       "type": "Feature",
- *       "properties": {},
- *       "geometry": {
- *         "type": "Point",
- *         "coordinates": [-97.522259, 35.4691]
- *       }
- *     }, {
- *       "type": "Feature",
- *       "properties": {},
- *       "geometry": {
- *         "type": "Point",
- *         "coordinates": [-97.502754, 35.463455]
- *       }
- *     }, {
- *       "type": "Feature",
- *       "properties": {},
- *       "geometry": {
- *         "type": "Point",
- *         "coordinates": [-97.508269, 35.463245]
- *       }
- *     }
- *   ]
- * };
+ * var features = turf.featureCollection([
+ *     turf.point([-97.522259, 35.4691]),
+ *     turf.point([-97.502754, 35.463455]),
+ *     turf.point([-97.508269, 35.463245])
+ * ]);
  *
  * var center = turf.center(features);
  *
diff --git a/packages/turf-clusters-dbscan/README.md b/packages/turf-clusters-dbscan/README.md
index 2997aa986e..33d5c24882 100644
--- a/packages/turf-clusters-dbscan/README.md
+++ b/packages/turf-clusters-dbscan/README.md
@@ -6,11 +6,11 @@ Takes a set of [points](http://geojson.org/geojson-spec.html#point) and partitio
 
 **Parameters**
 
--   `points` **([FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects) \| [Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[Feature](http://geojson.org/geojson-spec.html#feature-objects)>)** to be clustered
+-   `points` **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** to be clustered
 -   `maxDistance` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** Maximum Distance between any point of the cluster to generate the clusters (kilometers only)
 -   `units` **\[[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** in which `maxDistance` is expressed, can be degrees, radians, miles, or kilometers (optional, default `kilometers`)
--   `minPoints` **\[[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)]** Minimum number of points to generate a single cluster, points will be excluded if the
-        cluster does not meet the minimum amounts of points. (optional, default `3`)
+-   `minPoints` **\[[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)]** Minimum number of points to generate a single cluster,
+    points which do not meet this requirement will be classified as an 'edge' or 'noise'. (optional, default `3`)
 
 **Examples**
 
@@ -23,11 +23,11 @@ var distance = 100;
 var clustered = turf.clustersDbscan(points, distance);
 
 //addToMap
-var addToMap = featureCollection(clustered.points);
+var addToMap = clustered;
 ```
 
-Returns **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** each Point has two extra properties; `cluster` property with the cluster number it belongs &
-`dbscan` which is defines the which type of point it has been flagged as ('core'|'edge'|'noise').
+Returns **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** Clustered Points with an additional two properties associated to each Feature:-   {number} cluster - the associated clusterId
+-   {string} dbscan - type of point it has been classified as ('core'|'edge'|'noise')
 
 <!-- This file is automatically generated. Please don't edit it directly:
 if you find an error, edit the source file (likely index.js), and re-run
diff --git a/packages/turf-destination/README.md b/packages/turf-destination/README.md
index 1d6c6fb480..412dba6c91 100644
--- a/packages/turf-destination/README.md
+++ b/packages/turf-destination/README.md
@@ -14,14 +14,7 @@ Takes a [Point](http://geojson.org/geojson-spec.html#point) and calculates the l
 **Examples**
 
 ```javascript
-var point = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.343, 39.984]
-  }
-};
+var point = turf.point([-75.343, 39.984]);
 var distance = 50;
 var bearing = 90;
 var units = 'miles';
diff --git a/packages/turf-destination/index.js b/packages/turf-destination/index.js
index 6dbf8ec44a..9311f5ec3c 100644
--- a/packages/turf-destination/index.js
+++ b/packages/turf-destination/index.js
@@ -15,14 +15,7 @@ var distanceToRadians = helpers.distanceToRadians;
  * @param {string} [units=kilometers] miles, kilometers, degrees, or radians
  * @returns {Feature<Point>} destination point
  * @example
- * var point = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.343, 39.984]
- *   }
- * };
+ * var point = turf.point([-75.343, 39.984]);
  * var distance = 50;
  * var bearing = 90;
  * var units = 'miles';
diff --git a/packages/turf-distance/README.md b/packages/turf-distance/README.md
index 814134f1d2..9d317dd55f 100644
--- a/packages/turf-distance/README.md
+++ b/packages/turf-distance/README.md
@@ -16,22 +16,8 @@ to account for global curvature.
 **Examples**
 
 ```javascript
-var from = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.343, 39.984]
-  }
-};
-var to = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.534, 39.123]
-  }
-};
+var from = turf.point([-75.343, 39.984]);
+var to = turf.point([-75.534, 39.123]);
 
 var distance = turf.distance(from, to, "miles");
 
diff --git a/packages/turf-distance/index.js b/packages/turf-distance/index.js
index 05c110df73..7383b3eb97 100644
--- a/packages/turf-distance/index.js
+++ b/packages/turf-distance/index.js
@@ -15,22 +15,8 @@ var radiansToDistance = require('@turf/helpers').radiansToDistance;
  * @param {string} [units=kilometers] can be degrees, radians, miles, or kilometers
  * @returns {number} distance between the two points
  * @example
- * var from = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.343, 39.984]
- *   }
- * };
- * var to = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.534, 39.123]
- *   }
- * };
+ * var from = turf.point([-75.343, 39.984]);
+ * var to = turf.point([-75.534, 39.123]);
  *
  * var distance = turf.distance(from, to, "miles");
  *
diff --git a/packages/turf-helpers/README.md b/packages/turf-helpers/README.md
index 0437f026a3..07fc5b8915 100644
--- a/packages/turf-helpers/README.md
+++ b/packages/turf-helpers/README.md
@@ -237,10 +237,10 @@ Round number to precision
 **Examples**
 
 ```javascript
-round(120.4321)
+turf.round(120.4321)
 //=120
 
-round(120.4321, 2)
+turf.round(120.4321, 2)
 //=120.43
 ```
 
diff --git a/packages/turf-helpers/index.js b/packages/turf-helpers/index.js
index eacfe0de59..3c8a6517a6 100644
--- a/packages/turf-helpers/index.js
+++ b/packages/turf-helpers/index.js
@@ -292,10 +292,10 @@ var areaFactors = {
  * @param {number} [precision=0] Precision
  * @returns {number} rounded number
  * @example
- * round(120.4321)
+ * turf.round(120.4321)
  * //=120
  *
- * round(120.4321, 2)
+ * turf.round(120.4321, 2)
  * //=120.43
  */
 function round(num, precision) {
diff --git a/packages/turf-interpolate/README.md b/packages/turf-interpolate/README.md
index cbe083ffd2..6555ed56fd 100644
--- a/packages/turf-interpolate/README.md
+++ b/packages/turf-interpolate/README.md
@@ -2,13 +2,13 @@
 
 # interpolate
 
-Takes a set of points and estimates their 'property' values on a grid using the Inverse Distance Weighting (IDW) method.](<https://en.wikipedia.org/wiki/Inverse_distance_weighting>.
+Takes a set of points and estimates their 'property' values on a grid using the [Inverse Distance Weighting (IDW) method](https://en.wikipedia.org/wiki/Inverse_distance_weighting).
 
 **Parameters**
 
 -   `points` **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** with known value
 -   `cellSize` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** the distance across each grid point
--   `gridType` **\[[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** defines if the output will be a `squareGrid` (`outputType`='squares'), a `pointGrid` (`outputType`='points'), a `haxGrid` (`outputType`='hex') or a `triangleGrid` (`outputType`='triangle').
+-   `gridType` **\[[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** defines the output format based on a Grid Type (options: 'square' | 'point' | 'hex' | 'triangle') (optional, default `'square'`)
 -   `property` **\[[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** the property name in `points` from which z-values will be pulled, zValue fallbacks to 3rd coordinate if no property exists. (optional, default `'elevation'`)
 -   `units` **\[[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** used in calculating cellSize, can be degrees, radians, miles, or kilometers (optional, default `kilometers`)
 -   `weight` **\[[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)]** exponent regulating the distance-decay weighting (optional, default `1`)
@@ -29,7 +29,7 @@ var grid = turf.interpolate(points, 100, 'points', 'solRad', 'miles');
 var addToMap = grid
 ```
 
-Returns **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)|[Polygon](http://geojson.org/geojson-spec.html#polygon)>** grid of points or polygons with interpolated 'property'
+Returns **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;([Point](http://geojson.org/geojson-spec.html#point) \| [Polygon](http://geojson.org/geojson-spec.html#polygon))>** grid of points or polygons with interpolated 'property'
 
 <!-- This file is automatically generated. Please don't edit it directly:
 if you find an error, edit the source file (likely index.js), and re-run
diff --git a/packages/turf-invariant/README.md b/packages/turf-invariant/README.md
index 0e9be2b64b..e5a9017429 100644
--- a/packages/turf-invariant/README.md
+++ b/packages/turf-invariant/README.md
@@ -90,7 +90,7 @@ var point = {
     "coordinates": [110, 40]
   }
 }
-var geom = invariant.getGeom(point)
+var geom = turf.getGeom(point)
 //={"type": "Point", "coordinates": [110, 40]}
 ```
 
@@ -117,7 +117,7 @@ var point = {
     "coordinates": [110, 40]
   }
 }
-var geom = invariant.getGeom(point)
+var geom = turf.getGeom(point)
 //="Point"
 ```
 
diff --git a/packages/turf-invariant/index.js b/packages/turf-invariant/index.js
index 70b7da9fcf..ff1c87591b 100644
--- a/packages/turf-invariant/index.js
+++ b/packages/turf-invariant/index.js
@@ -151,7 +151,7 @@ function collectionOf(featureCollection, type, name) {
  *     "coordinates": [110, 40]
  *   }
  * }
- * var geom = invariant.getGeom(point)
+ * var geom = turf.getGeom(point)
  * //={"type": "Point", "coordinates": [110, 40]}
  */
 function getGeom(geojson) {
@@ -176,7 +176,7 @@ function getGeom(geojson) {
  *     "coordinates": [110, 40]
  *   }
  * }
- * var geom = invariant.getGeom(point)
+ * var geom = turf.getGeom(point)
  * //="Point"
  */
 function getGeomType(geojson) {
diff --git a/packages/turf-line-distance/README.md b/packages/turf-line-distance/README.md
index a74291c2b6..382edd502c 100644
--- a/packages/turf-line-distance/README.md
+++ b/packages/turf-line-distance/README.md
@@ -12,21 +12,14 @@ Takes a [LineString](http://geojson.org/geojson-spec.html#linestring) or [Polygo
 **Examples**
 
 ```javascript
-var line = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "LineString",
-    "coordinates": [
-      [-77.031669, 38.878605],
-      [-77.029609, 38.881946],
-      [-77.020339, 38.884084],
-      [-77.025661, 38.885821],
-      [-77.021884, 38.889563],
-      [-77.019824, 38.892368]
-    ]
-  }
-};
+var line = turf.lineString([
+    [-77.031669, 38.878605],
+    [-77.029609, 38.881946],
+    [-77.020339, 38.884084],
+    [-77.025661, 38.885821],
+    [-77.021884, 38.889563],
+    [-77.019824, 38.892368]
+]);
 
 var length = turf.lineDistance(line, 'miles');
 
diff --git a/packages/turf-line-distance/index.js b/packages/turf-line-distance/index.js
index e209e59e70..e5342a1737 100644
--- a/packages/turf-line-distance/index.js
+++ b/packages/turf-line-distance/index.js
@@ -16,21 +16,14 @@ var lineString = helpers.lineString;
  * @param {string} [units=kilometers] can be degrees, radians, miles, or kilometers
  * @returns {number} length feature
  * @example
- * var line = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "LineString",
- *     "coordinates": [
- *       [-77.031669, 38.878605],
- *       [-77.029609, 38.881946],
- *       [-77.020339, 38.884084],
- *       [-77.025661, 38.885821],
- *       [-77.021884, 38.889563],
- *       [-77.019824, 38.892368]
- *     ]
- *   }
- * };
+ * var line = turf.lineString([
+ *     [-77.031669, 38.878605],
+ *     [-77.029609, 38.881946],
+ *     [-77.020339, 38.884084],
+ *     [-77.025661, 38.885821],
+ *     [-77.021884, 38.889563],
+ *     [-77.019824, 38.892368]
+ * ]);
  *
  * var length = turf.lineDistance(line, 'miles');
  *
diff --git a/packages/turf-line-intersect/README.md b/packages/turf-line-intersect/README.md
index bc9988f8e0..e630faaa56 100644
--- a/packages/turf-line-intersect/README.md
+++ b/packages/turf-line-intersect/README.md
@@ -12,26 +12,12 @@ Takes any LineString or Polygon GeoJSON and returns the intersecting point(s).
 **Examples**
 
 ```javascript
-var line1 = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "LineString",
-    "coordinates": [[126, -11], [129, -21]]
-  }
-};
-var line2 = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "LineString",
-    "coordinates": [[123, -18], [131, -14]]
-  }
-};
+var line1 = turf.lineString([[126, -11], [129, -21]]);
+var line2 = turf.lineString([[123, -18], [131, -14]]);
 var intersects = turf.lineIntersect(line1, line2);
 
 //addToMap
-var addToMap = [line, line2, intersects]
+var addToMap = [line1, line2, intersects]
 ```
 
 Returns **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** point(s) that intersect both
diff --git a/packages/turf-line-intersect/index.js b/packages/turf-line-intersect/index.js
index fc84d39a56..50ac2fce59 100644
--- a/packages/turf-line-intersect/index.js
+++ b/packages/turf-line-intersect/index.js
@@ -15,26 +15,12 @@ var featureCollection = helpers.featureCollection;
  * @param {Geometry|FeatureCollection|Feature<LineString|MultiLineString|Polygon|MultiPolygon>} line2 any LineString or Polygon
  * @returns {FeatureCollection<Point>} point(s) that intersect both
  * @example
- * var line1 = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "LineString",
- *     "coordinates": [[126, -11], [129, -21]]
- *   }
- * };
- * var line2 = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "LineString",
- *     "coordinates": [[123, -18], [131, -14]]
- *   }
- * };
+ * var line1 = turf.lineString([[126, -11], [129, -21]]);
+ * var line2 = turf.lineString([[123, -18], [131, -14]]);
  * var intersects = turf.lineIntersect(line1, line2);
  *
  * //addToMap
- * var addToMap = [line, line2, intersects]
+ * var addToMap = [line1, line2, intersects]
  */
 module.exports = function (line1, line2) {
     var unique = {};
diff --git a/packages/turf-midpoint/README.md b/packages/turf-midpoint/README.md
index 5770a35714..d0b868c9a1 100644
--- a/packages/turf-midpoint/README.md
+++ b/packages/turf-midpoint/README.md
@@ -7,34 +7,20 @@ The midpoint is calculated geodesically, meaning the curvature of the earth is t
 
 **Parameters**
 
--   `from` **[Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** first point
--   `to` **[Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** second point
+-   `point1` **([Geometry](http://geojson.org/geojson-spec.html#geometry) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)> | [Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)>)** first point
+-   `point2` **([Geometry](http://geojson.org/geojson-spec.html#geometry) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)> | [Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)>)** second point
 
 **Examples**
 
 ```javascript
-var pt1 = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [144.834823, -37.771257]
-  }
-};
-var pt2 = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [145.14244, -37.830937]
-  }
-};
-
-var midpoint = turf.midpoint(pt1, pt2);
+var point1 = turf.point([144.834823, -37.771257]);
+var point2 = turf.point([145.14244, -37.830937]);
 
-//addToMap
+var midpoint = turf.midpoint(point1, point2);
 midpoint.properties['marker-color'] = '#f00';
-var addToMap = [pt1, pt2, midpoint];
+
+//addToMap
+var addToMap = [point1, point2, midpoint];
 ```
 
 Returns **[Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** a point midway between `pt1` and `pt2`
diff --git a/packages/turf-midpoint/index.d.ts b/packages/turf-midpoint/index.d.ts
index cff299a8f0..b59ba74c6c 100644
--- a/packages/turf-midpoint/index.d.ts
+++ b/packages/turf-midpoint/index.d.ts
@@ -1,10 +1,11 @@
 /// <reference types="geojson" />
 
-type Point = GeoJSON.Feature<GeoJSON.Point>;
+type Point = GeoJSON.Feature<GeoJSON.Point> | GeoJSON.Point | number[];
+type Feature = GeoJSON.Feature<GeoJSON.Point>;
 
 /**
  * http://turfjs.org/docs/#midpoint
  */
-declare function midpoint(from: Point, to: Point): Point;
+declare function midpoint(point1: Point, point2: Point): Feature;
 declare namespace midpoint { }
 export = midpoint;
diff --git a/packages/turf-midpoint/index.js b/packages/turf-midpoint/index.js
index c0defd049a..dc3cbdc7ff 100644
--- a/packages/turf-midpoint/index.js
+++ b/packages/turf-midpoint/index.js
@@ -7,37 +7,23 @@ var distance = require('@turf/distance');
  * The midpoint is calculated geodesically, meaning the curvature of the earth is taken into account.
  *
  * @name midpoint
- * @param {Feature<Point>} from first point
- * @param {Feature<Point>} to second point
+ * @param {Geometry|Feature<Point>|Array<number>} point1 first point
+ * @param {Geometry|Feature<Point>|Array<number>} point2 second point
  * @returns {Feature<Point>} a point midway between `pt1` and `pt2`
  * @example
- * var pt1 = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [144.834823, -37.771257]
- *   }
- * };
- * var pt2 = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [145.14244, -37.830937]
- *   }
- * };
+ * var point1 = turf.point([144.834823, -37.771257]);
+ * var point2 = turf.point([145.14244, -37.830937]);
  *
- * var midpoint = turf.midpoint(pt1, pt2);
+ * var midpoint = turf.midpoint(point1, point2);
+ * midpoint.properties['marker-color'] = '#f00';
  *
  * //addToMap
- * midpoint.properties['marker-color'] = '#f00';
- * var addToMap = [pt1, pt2, midpoint];
+ * var addToMap = [point1, point2, midpoint];
 */
-module.exports = function (from, to) {
-    var dist = distance(from, to, 'miles');
-    var heading = bearing(from, to);
-    var midpoint = destination(from, dist / 2, heading, 'miles');
+module.exports = function (point1, point2) {
+    var dist = distance(point1, point2, 'miles');
+    var heading = bearing(point1, point2);
+    var midpoint = destination(point1, dist / 2, heading, 'miles');
 
     return midpoint;
 };
diff --git a/packages/turf-nearest/README.md b/packages/turf-nearest/README.md
index 0f5a169de2..67e37c28dc 100644
--- a/packages/turf-nearest/README.md
+++ b/packages/turf-nearest/README.md
@@ -9,55 +9,24 @@ is geodesic.
 
 **Parameters**
 
--   `targetPoint` **[Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** the reference point
+-   `targetPoint` **([Geometry](http://geojson.org/geojson-spec.html#geometry) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)> | [Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)>)** the reference point
 -   `points` **[FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** against input point set
 
 **Examples**
 
 ```javascript
-var point = {
-  "type": "Feature",
-  "properties": {
-    "marker-color": "#0f0"
-  },
-  "geometry": {
-    "type": "Point",
-    "coordinates": [28.965797, 41.010086]
-  }
-};
-var against = {
-  "type": "FeatureCollection",
-  "features": [
-    {
-      "type": "Feature",
-      "properties": {},
-      "geometry": {
-        "type": "Point",
-        "coordinates": [28.973865, 41.011122]
-      }
-    }, {
-      "type": "Feature",
-      "properties": {},
-      "geometry": {
-        "type": "Point",
-        "coordinates": [28.948459, 41.024204]
-      }
-    }, {
-      "type": "Feature",
-      "properties": {},
-      "geometry": {
-        "type": "Point",
-        "coordinates": [28.938674, 41.013324]
-      }
-    }
-  ]
-};
-
-var nearest = turf.nearest(point, against);
+var targetPoint = turf.point([28.965797, 41.010086], {"marker-color": "#0f0"});
+var points = turf.featureCollection([
+    turf.point([28.973865, 41.011122]),
+    turf.point([28.948459, 41.024204]),
+    turf.point([28.938674, 41.013324])
+]);
+
+var nearest = turf.nearest(targetPoint, points);
 
 //addToMap
 nearest.properties['marker-color'] = '#f00';
-var addToMap = [point, against, nearest];
+var addToMap = [targetPoint, points, nearest];
 ```
 
 Returns **[Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** the closest point in the set to the reference point
diff --git a/packages/turf-nearest/index.d.ts b/packages/turf-nearest/index.d.ts
index b58710f7cb..1420345654 100644
--- a/packages/turf-nearest/index.d.ts
+++ b/packages/turf-nearest/index.d.ts
@@ -1,11 +1,12 @@
 /// <reference types="geojson" />
 
-type Point = GeoJSON.Feature<GeoJSON.Point>;
+type Point = GeoJSON.Feature<GeoJSON.Point> | GeoJSON.Point | number[];
 type Points = GeoJSON.FeatureCollection<GeoJSON.Point>;
+type Feature = GeoJSON.Feature<GeoJSON.Point>;
 
 /**
  * http://turfjs.org/docs/#nearest
  */
-declare function nearest(targetPoint: Point, points: Point): Point;
+declare function nearest(targetPoint: Point, points: Points): Feature;
 declare namespace nearest { }
 export = nearest;
diff --git a/packages/turf-nearest/index.js b/packages/turf-nearest/index.js
index 168767e0dc..b7e5acc602 100644
--- a/packages/turf-nearest/index.js
+++ b/packages/turf-nearest/index.js
@@ -7,53 +7,22 @@ var distance = require('@turf/distance');
  * is geodesic.
  *
  * @name nearest
- * @param {Feature<Point>} targetPoint the reference point
+ * @param {Geometry|Feature<Point>|Array<number>} targetPoint the reference point
  * @param {FeatureCollection<Point>} points against input point set
  * @returns {Feature<Point>} the closest point in the set to the reference point
  * @example
- * var point = {
- *   "type": "Feature",
- *   "properties": {
- *     "marker-color": "#0f0"
- *   },
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [28.965797, 41.010086]
- *   }
- * };
- * var against = {
- *   "type": "FeatureCollection",
- *   "features": [
- *     {
- *       "type": "Feature",
- *       "properties": {},
- *       "geometry": {
- *         "type": "Point",
- *         "coordinates": [28.973865, 41.011122]
- *       }
- *     }, {
- *       "type": "Feature",
- *       "properties": {},
- *       "geometry": {
- *         "type": "Point",
- *         "coordinates": [28.948459, 41.024204]
- *       }
- *     }, {
- *       "type": "Feature",
- *       "properties": {},
- *       "geometry": {
- *         "type": "Point",
- *         "coordinates": [28.938674, 41.013324]
- *       }
- *     }
- *   ]
- * };
+ * var targetPoint = turf.point([28.965797, 41.010086], {"marker-color": "#0f0"});
+ * var points = turf.featureCollection([
+ *     turf.point([28.973865, 41.011122]),
+ *     turf.point([28.948459, 41.024204]),
+ *     turf.point([28.938674, 41.013324])
+ * ]);
  *
- * var nearest = turf.nearest(point, against);
+ * var nearest = turf.nearest(targetPoint, points);
  *
  * //addToMap
  * nearest.properties['marker-color'] = '#f00';
- * var addToMap = [point, against, nearest];
+ * var addToMap = [targetPoint, points, nearest];
  */
 module.exports = function (targetPoint, points) {
     var nearestPoint, minDist = Infinity;
diff --git a/packages/turf-planepoint/README.md b/packages/turf-planepoint/README.md
index 0755cfbb71..9b809c4524 100644
--- a/packages/turf-planepoint/README.md
+++ b/packages/turf-planepoint/README.md
@@ -17,14 +17,6 @@ if their values are not provided as properties.
 **Examples**
 
 ```javascript
-var point = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.3221, 39.529]
-  }
-};
 var point = turf.point([-75.3221, 39.529]);
 // triangle is a polygon with "a", "b",
 // and "c" values representing
diff --git a/packages/turf-planepoint/index.js b/packages/turf-planepoint/index.js
index 2b13bc72f5..9f7cf088b0 100644
--- a/packages/turf-planepoint/index.js
+++ b/packages/turf-planepoint/index.js
@@ -15,14 +15,6 @@ var getGeom = invariant.getGeom;
  * @param {Geometry|Feature<Polygon>} triangle a Polygon feature with three vertices
  * @returns {number} the z-value for `interpolatedPoint`
  * @example
- * var point = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.3221, 39.529]
- *   }
- * };
  * var point = turf.point([-75.3221, 39.529]);
  * // triangle is a polygon with "a", "b",
  * // and "c" values representing
diff --git a/packages/turf-point-grid/README.md b/packages/turf-point-grid/README.md
index 2ac139ea81..5c361bd1fa 100644
--- a/packages/turf-point-grid/README.md
+++ b/packages/turf-point-grid/README.md
@@ -9,7 +9,7 @@ Creates a [Point](http://geojson.org/geojson-spec.html#point) grid from a boundi
 -   `bbox` **([Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)> | [FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;any>)** extent in [minX, minY, maxX, maxY] order
 -   `cellSide` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** the distance between points
 -   `units` **\[[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** used in calculating cellSide, can be degrees, radians, miles, or kilometers (optional, default `kilometers`)
--   `centered` **\[[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** adjust points position to center the grid into bbox (optional, default `true`).  **This parameter is going to be removed** in the next major release, having the output always centered into bbox.
+-   `centered` **\[[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** adjust points position to center the grid into bbox. **This parameter is going to be removed** in the next major release, having the output always centered into bbox. (optional, default `true`)
 -   `bboxIsMask` **\[[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** if true, and bbox is a Polygon or MultiPolygon, the grid Point will be created
     only if inside the bbox Polygon(s) (optional, default `false`)
 
diff --git a/packages/turf-point-on-line/README.md b/packages/turf-point-on-line/README.md
index 2ed742e14e..fec1e8bc5f 100644
--- a/packages/turf-point-on-line/README.md
+++ b/packages/turf-point-on-line/README.md
@@ -2,40 +2,26 @@
 
 # pointOnLine
 
-Takes a [Point](http://geojson.org/geojson-spec.html#point) and a [LineString](http://geojson.org/geojson-spec.html#linestring) or [MultiLineString](http://geojson.org/geojson-spec.html#multilinestring) and calculates the closest Point on the (Multi)LineString.
+Takes a [Point](http://geojson.org/geojson-spec.html#point) and a [LineString](http://geojson.org/geojson-spec.html#linestring) and calculates the closest Point on the (Multi)LineString.
 
 **Parameters**
 
--   `lines` **[Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[LineString](http://geojson.org/geojson-spec.html#linestring)|[MultiLineString](http://geojson.org/geojson-spec.html#multilinestring)>** lines to snap to
--   `pt` **[Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)>** point to snap from
+-   `lines` **([Geometry](http://geojson.org/geojson-spec.html#geometry) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;([LineString](http://geojson.org/geojson-spec.html#linestring) \| [MultiLineString](http://geojson.org/geojson-spec.html#multilinestring))>)** lines to snap to
+-   `pt` **([Geometry](http://geojson.org/geojson-spec.html#geometry) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;[Point](http://geojson.org/geojson-spec.html#point)> | [Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)>)** point to snap from
 -   `units` **\[[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** can be degrees, radians, miles, or kilometers (optional, default `kilometers`)
 
 **Examples**
 
 ```javascript
-var line = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "LineString",
-    "coordinates": [
-      [-77.031669, 38.878605],
-      [-77.029609, 38.881946],
-      [-77.020339, 38.884084],
-      [-77.025661, 38.885821],
-      [-77.021884, 38.889563],
-      [-77.019824, 38.892368]
-    ]
-  }
-};
-var pt = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-77.037076, 38.884017]
-  }
-};
+var line = turf.lineString([
+    [-77.031669, 38.878605],
+    [-77.029609, 38.881946],
+    [-77.020339, 38.884084],
+    [-77.025661, 38.885821],
+    [-77.021884, 38.889563],
+    [-77.019824, 38.892368]
+]);
+var pt = turf.point([-77.037076, 38.884017]);
 
 var snapped = turf.pointOnLine(line, pt, 'miles');
 
diff --git a/packages/turf-point-on-line/index.js b/packages/turf-point-on-line/index.js
index cecd54191b..4087fb53f7 100644
--- a/packages/turf-point-on-line/index.js
+++ b/packages/turf-point-on-line/index.js
@@ -19,29 +19,15 @@ var flattenEach = meta.flattenEach;
  * @param {string} [units=kilometers] can be degrees, radians, miles, or kilometers
  * @returns {Feature<Point>} closest point on the `line` to `point`. The properties object will contain three values: `index`: closest point was found on nth line part, `dist`: distance between pt and the closest point, `location`: distance along the line between start and the closest point.
  * @example
- * var line = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "LineString",
- *     "coordinates": [
- *       [-77.031669, 38.878605],
- *       [-77.029609, 38.881946],
- *       [-77.020339, 38.884084],
- *       [-77.025661, 38.885821],
- *       [-77.021884, 38.889563],
- *       [-77.019824, 38.892368]
- *     ]
- *   }
- * };
- * var pt = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-77.037076, 38.884017]
- *   }
- * };
+ * var line = turf.lineString([
+ *     [-77.031669, 38.878605],
+ *     [-77.029609, 38.881946],
+ *     [-77.020339, 38.884084],
+ *     [-77.025661, 38.885821],
+ *     [-77.021884, 38.889563],
+ *     [-77.019824, 38.892368]
+ * ]);
+ * var pt = turf.point([-77.037076, 38.884017]);
  *
  * var snapped = turf.pointOnLine(line, pt, 'miles');
  *
diff --git a/packages/turf-rhumb-bearing/README.md b/packages/turf-rhumb-bearing/README.md
index ef93ce63fe..05b4bc9f7a 100644
--- a/packages/turf-rhumb-bearing/README.md
+++ b/packages/turf-rhumb-bearing/README.md
@@ -14,26 +14,8 @@ i.e. the angle measured in degrees start the north line (0 degrees)
 **Examples**
 
 ```javascript
-var point1 = {
-  "type": "Feature",
-  "properties": {
-    "marker-color": "#F00"
-  },
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.343, 39.984]
-  }
-};
-var point2 = {
-  "type": "Feature",
-  "properties": {
-    "marker-color": "#00F"
-  },
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.534, 39.123]
-  }
-};
+var point1 = turf.point([-75.343, 39.984], {"marker-color": "#F00"});
+var point2 = turf.point([-75.534, 39.123], {"marker-color": "#00F"});
 
 var bearing = turf.rhumbBearing(point1, point2);
 
diff --git a/packages/turf-rhumb-bearing/index.js b/packages/turf-rhumb-bearing/index.js
index 67e1747168..205b76180c 100644
--- a/packages/turf-rhumb-bearing/index.js
+++ b/packages/turf-rhumb-bearing/index.js
@@ -13,26 +13,8 @@ var GeodesyLatLon = require('geodesy').LatLonSpherical;
  * @param {boolean} [final=false] calculates the final bearing if true
  * @returns {number} bearing from north in decimal degrees, between -180 and 180 degrees (positive clockwise)
  * @example
- * var point1 = {
- *   "type": "Feature",
- *   "properties": {
- *     "marker-color": "#F00"
- *   },
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.343, 39.984]
- *   }
- * };
- * var point2 = {
- *   "type": "Feature",
- *   "properties": {
- *     "marker-color": "#00F"
- *   },
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.534, 39.123]
- *   }
- * };
+ * var point1 = turf.point([-75.343, 39.984], {"marker-color": "#F00"});
+ * var point2 = turf.point([-75.534, 39.123], {"marker-color": "#00F"});
  *
  * var bearing = turf.rhumbBearing(point1, point2);
  *
@@ -51,11 +33,9 @@ module.exports = function (start, end, final) {
     var origin = new GeodesyLatLon(coordsStart[1], coordsStart[0]);
     var destination = new GeodesyLatLon(coordsEnd[1], coordsEnd[0]);
     var bear360;
-    if (final) {
-        bear360 = destination.rhumbBearingTo(origin);
-    } else {
-        bear360 = origin.rhumbBearingTo(destination);
-    }
+
+    if (final) bear360 = destination.rhumbBearingTo(origin);
+    else bear360 = origin.rhumbBearingTo(destination);
 
     var bear180 = (bear360 > 180) ? -(360 - bear360) : bear360;
 
diff --git a/packages/turf-rhumb-destination/README.md b/packages/turf-rhumb-destination/README.md
index d422afd572..7610ecdeef 100644
--- a/packages/turf-rhumb-destination/README.md
+++ b/packages/turf-rhumb-destination/README.md
@@ -15,16 +15,7 @@ origin Point with the (constant) given bearing.
 **Examples**
 
 ```javascript
-var point = {
-  "type": "Feature",
-  "properties": {
-    "marker-color": "F00"
-  },
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.343, 39.984]
-  }
-};
+var point = turf.point([-75.343, 39.984], {"marker-color": "F00"});
 var distance = 50;
 var bearing = 90;
 var units = 'miles';
diff --git a/packages/turf-rhumb-destination/index.js b/packages/turf-rhumb-destination/index.js
index 332af3d744..915f1cafc6 100644
--- a/packages/turf-rhumb-destination/index.js
+++ b/packages/turf-rhumb-destination/index.js
@@ -18,16 +18,7 @@ var distanceToRadians = helpers.distanceToRadians;
  * @param {string} [units=kilometers] miles, kilometers, degrees, or radians
  * @returns {Feature<Point>} Destination point.
  * @example
- * var point = {
- *   "type": "Feature",
- *   "properties": {
- *     "marker-color": "F00"
- *   },
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.343, 39.984]
- *   }
- * };
+ * var point = turf.point([-75.343, 39.984], {"marker-color": "F00"});
  * var distance = 50;
  * var bearing = 90;
  * var units = 'miles';
diff --git a/packages/turf-rhumb-distance/README.md b/packages/turf-rhumb-distance/README.md
index 1ac1924605..1051406db8 100644
--- a/packages/turf-rhumb-distance/README.md
+++ b/packages/turf-rhumb-distance/README.md
@@ -14,22 +14,8 @@ miles, or kilometers.
 **Examples**
 
 ```javascript
-var from = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.343, 39.984]
-  }
-};
-var to = {
-  "type": "Feature",
-  "properties": {},
-  "geometry": {
-    "type": "Point",
-    "coordinates": [-75.534, 39.123]
-  }
-};
+var from = turf.point([-75.343, 39.984]);
+var to = turf.point([-75.534, 39.123]);
 
 var distance = turf.rhumbDistance(from, to, "miles");
 
diff --git a/packages/turf-rhumb-distance/index.js b/packages/turf-rhumb-distance/index.js
index ab2c5204d1..a891d7c1dc 100644
--- a/packages/turf-rhumb-distance/index.js
+++ b/packages/turf-rhumb-distance/index.js
@@ -16,22 +16,8 @@ var distanceToRadians = helpers.distanceToRadians;
  * @param {string} [units=kilometers] can be degrees, radians, miles, or kilometers
  * @returns {number} distance between the two points
  * @example
- * var from = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.343, 39.984]
- *   }
- * };
- * var to = {
- *   "type": "Feature",
- *   "properties": {},
- *   "geometry": {
- *     "type": "Point",
- *     "coordinates": [-75.534, 39.123]
- *   }
- * };
+ * var from = turf.point([-75.343, 39.984]);
+ * var to = turf.point([-75.534, 39.123]);
  *
  * var distance = turf.rhumbDistance(from, to, "miles");
  *
diff --git a/packages/turf-truncate/README.md b/packages/turf-truncate/README.md
index 609cd1e8ac..717ccd9370 100644
--- a/packages/turf-truncate/README.md
+++ b/packages/turf-truncate/README.md
@@ -6,7 +6,7 @@ Takes a GeoJSON Feature or FeatureCollection and truncates the precision of the
 
 **Parameters**
 
--   `geojson` **([FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;any>)** any GeoJSON Feature, FeatureCollection, Geometry or GeometryCollection.
+-   `geojson` **([FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects))** any GeoJSON Feature, FeatureCollection, Geometry or GeometryCollection.
 -   `precision` **\[[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)]** coordinate decimal precision (optional, default `6`)
 -   `coordinates` **\[[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)]** maximum number of coordinates (primarly used to remove z coordinates) (optional, default `3`)
 -   `mutate` **\[[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** allows GeoJSON input to be mutated (significant performance increase if true) (optional, default `false`)
@@ -14,25 +14,18 @@ Takes a GeoJSON Feature or FeatureCollection and truncates the precision of the
 **Examples**
 
 ```javascript
-var point = {
-    "type": "Feature",
-    "properties": {}
-    "geometry": {
-        "type": "Point",
-        "coordinates": [
-            70.46923055566859,
-            58.11088890802906,
-            1508
-        ]
-    }
-};
+var point = turf.point([
+    70.46923055566859,
+    58.11088890802906,
+    1508
+]);
 var truncated = turf.truncate(point);
 
 //addToMap
 var addToMap = [truncated];
 ```
 
-Returns **([FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects)&lt;any>)** layer with truncated geometry
+Returns **([FeatureCollection](http://geojson.org/geojson-spec.html#feature-collection-objects) \| [Feature](http://geojson.org/geojson-spec.html#feature-objects))** layer with truncated geometry
 
 <!-- This file is automatically generated. Please don't edit it directly:
 if you find an error, edit the source file (likely index.js), and re-run
diff --git a/packages/turf-truncate/index.js b/packages/turf-truncate/index.js
index 9c56b79c66..97a253e88c 100644
--- a/packages/turf-truncate/index.js
+++ b/packages/turf-truncate/index.js
@@ -4,24 +4,17 @@ var coordEach = require('@turf/meta').coordEach;
  * Takes a GeoJSON Feature or FeatureCollection and truncates the precision of the geometry.
  *
  * @name truncate
- * @param {FeatureCollection|Feature<any>} geojson any GeoJSON Feature, FeatureCollection, Geometry or GeometryCollection.
+ * @param {FeatureCollection|Feature} geojson any GeoJSON Feature, FeatureCollection, Geometry or GeometryCollection.
  * @param {number} [precision=6] coordinate decimal precision
  * @param {number} [coordinates=3] maximum number of coordinates (primarly used to remove z coordinates)
  * @param {boolean} [mutate=false] allows GeoJSON input to be mutated (significant performance increase if true)
- * @returns {FeatureCollection|Feature<any>} layer with truncated geometry
+ * @returns {FeatureCollection|Feature} layer with truncated geometry
  * @example
- * var point = {
- *     "type": "Feature",
- *     "properties": {}
- *     "geometry": {
- *         "type": "Point",
- *         "coordinates": [
- *             70.46923055566859,
- *             58.11088890802906,
- *             1508
- *         ]
- *     }
- * };
+ * var point = turf.point([
+ *     70.46923055566859,
+ *     58.11088890802906,
+ *     1508
+ * ]);
  * var truncated = turf.truncate(point);
  *
  * //addToMap
diff --git a/packages/turf-union/README.md b/packages/turf-union/README.md
index ac2f284592..bc634efce7 100644
--- a/packages/turf-union/README.md
+++ b/packages/turf-union/README.md
@@ -11,38 +11,20 @@ Takes two or more [polygons](http://geojson.org/geojson-spec.html#polygon) and r
 **Examples**
 
 ```javascript
-var poly1 = {
-  "type": "Feature",
-  "properties": {
-    "fill": "#0f0"
-  },
-  "geometry": {
-    "type": "Polygon",
-    "coordinates": [[
-      [-82.574787, 35.594087],
-      [-82.574787, 35.615581],
-      [-82.545261, 35.615581],
-      [-82.545261, 35.594087],
-      [-82.574787, 35.594087]
-    ]]
-  }
-};
-var poly2 = {
-  "type": "Feature",
-  "properties": {
-    "fill": "#00f"
-  },
-  "geometry": {
-    "type": "Polygon",
-    "coordinates": [[
-      [-82.560024, 35.585153],
-      [-82.560024, 35.602602],
-      [-82.52964, 35.602602],
-      [-82.52964, 35.585153],
-      [-82.560024, 35.585153]
-    ]]
-  }
-};
+var poly1 = turf.polygon([[
+    [-82.574787, 35.594087],
+    [-82.574787, 35.615581],
+    [-82.545261, 35.615581],
+    [-82.545261, 35.594087],
+    [-82.574787, 35.594087]
+]], {"fill": "#0f0"});
+var poly2 = turf.polygon([[
+    [-82.560024, 35.585153],
+    [-82.560024, 35.602602],
+    [-82.52964, 35.602602],
+    [-82.52964, 35.585153],
+    [-82.560024, 35.585153]
+]], {"fill": "#00f"});
 
 var union = turf.union(poly1, poly2);
 
diff --git a/packages/turf-union/index.js b/packages/turf-union/index.js
index e46c93aaf9..a9a2a1c91f 100644
--- a/packages/turf-union/index.js
+++ b/packages/turf-union/index.js
@@ -7,38 +7,20 @@ var jsts = require('jsts');
  * @param {...Feature<Polygon>} A polygon to combine
  * @returns {Feature<(Polygon|MultiPolygon)>} a combined {@link Polygon} or {@link MultiPolygon} feature
  * @example
- * var poly1 = {
- *   "type": "Feature",
- *   "properties": {
- *     "fill": "#0f0"
- *   },
- *   "geometry": {
- *     "type": "Polygon",
- *     "coordinates": [[
- *       [-82.574787, 35.594087],
- *       [-82.574787, 35.615581],
- *       [-82.545261, 35.615581],
- *       [-82.545261, 35.594087],
- *       [-82.574787, 35.594087]
- *     ]]
- *   }
- * };
- * var poly2 = {
- *   "type": "Feature",
- *   "properties": {
- *     "fill": "#00f"
- *   },
- *   "geometry": {
- *     "type": "Polygon",
- *     "coordinates": [[
- *       [-82.560024, 35.585153],
- *       [-82.560024, 35.602602],
- *       [-82.52964, 35.602602],
- *       [-82.52964, 35.585153],
- *       [-82.560024, 35.585153]
- *     ]]
- *   }
- * };
+ * var poly1 = turf.polygon([[
+ *     [-82.574787, 35.594087],
+ *     [-82.574787, 35.615581],
+ *     [-82.545261, 35.615581],
+ *     [-82.545261, 35.594087],
+ *     [-82.574787, 35.594087]
+ * ]], {"fill": "#0f0"});
+ * var poly2 = turf.polygon([[
+ *     [-82.560024, 35.585153],
+ *     [-82.560024, 35.602602],
+ *     [-82.52964, 35.602602],
+ *     [-82.52964, 35.585153],
+ *     [-82.560024, 35.585153]
+ * ]], {"fill": "#00f"});
  *
  * var union = turf.union(poly1, poly2);
  *
diff --git a/packages/turf/test.js b/packages/turf/test.js
index 2414d43a18..70f8361d71 100644
--- a/packages/turf/test.js
+++ b/packages/turf/test.js
@@ -3,6 +3,7 @@ const path = require('path');
 const glob = require('glob');
 const test = require('tape');
 const documentation = require('documentation');
+const turf = require('./');
 
 // Helpers
 const directory = path.join(__dirname, '..');
@@ -161,6 +162,14 @@ const turf = require('./');
 function testString(turfFunction, example) {
     const turfName = turfFunction.name;
     const testFunctionName = turfName + 'Test';
+
+    // New modules will be excluded from tests
+    if (!turf.hasOwnProperty(turfName)) return `
+test('turf-${turfName}', t => {
+    t.skip('${turfName}');
+    t.end();
+});
+`
     return `
 test('turf-${turfName}', t => {
     const ${testFunctionName} = () => {