Adds clarification & examples to demystify Transforms. (#4653)

* Adds clarification & examples to demystify Transforms.

* Fleshes out documentation of NodeOptions for Transforms

* Update docs/concepts/04-transforms.md

Co-authored-by: Dylan Schiemann <dylan@dojotoolkit.org>

* Uses 'API' in the title of all API documents

Co-authored-by: Dylan Schiemann <dylan@dojotoolkit.org>

docs/api/locations/README.md

@@ -1,4 +1,4 @@
-# Location Types
+# Location Types APIs
 
 The `Location` interface is a union of the ways to refer to a specific location in a Slate document: paths, points or ranges. Methods will often accept a `Location` instead of requiring only a `Path`, `Point` or `Range`.
 

docs/api/locations/location.md

@@ -1,4 +1,4 @@
-# Location
+# Location API
 
 The Location interface is a union of the ways to refer to a specific location in a Slate document: paths, points or ranges. Methods will often accept a Location instead of requiring only a Path, Point or Range.
 

docs/api/locations/path.md

@@ -1,4 +1,4 @@
-# Path
+# Path API
 
 `Path` arrays are a list of indexes that describe a node's exact position in a Slate node tree. Although they are usually relative to the root `Editor` object, they can be relative to any `Node` object.
 

docs/api/locations/point-entry.md

@@ -1,4 +1,4 @@
-# PointEntry
+# PointEntry API
 
 `PointEntry` objects are returned when iterating over `Point` objects that belong to a range.
 

docs/api/locations/point-ref.md

@@ -1,4 +1,4 @@
-# PointRef
+# PointRef API
 
 `PointRef` objects keep a specific point in a document synced over time as new operations are applied to the editor. You can access their property `current` at any time for the up-to-date `Point` value.
 

docs/api/locations/point.md

@@ -1,6 +1,6 @@
-# Point
+# Point API
 
-`Point` objects refer to a specific location in a text node in a Slate document. Its `path` refers to the location of the node in the tree, and its offset refers to distance into the node's string of text. Points may only refer to `Text` nodes.
+`Point` objects refer to a specific location in a text node in a Slate document. Its `path` refers to the location of the node in the tree, and its `offset` refers to distance into the node's string of text. Points may only refer to `Text` nodes.
 
 ```typescript
 interface Point {

docs/api/locations/range-ref.md

@@ -1,4 +1,4 @@
-# RangeRef
+# RangeRef API
 
 `RangeRef` objects keep a specific range in a document synced over time as new operations are applied to the editor. You can access their property `current` at any time for the up-to-date `Range` value.
 

docs/api/locations/range.md

@@ -1,4 +1,4 @@
-# Range
+# Range API
 
 `Range` objects are a set of points that refer to a specific span of a Slate document. They can define a span inside a single node or they can span across multiple nodes. The editor's `selection` is stored as a range.
 

docs/api/locations/span.md

@@ -1,6 +1,6 @@
-# Span
+# Span API
 
-A `Span` is a low-level way to refer to a range using `Element` as the end points instead of a `Point` which requires the use of leaf text nodes.
+A `Span` is a low-level way to refer to a `Range` using `Element` as the end points instead of a `Point` which requires the use of leaf text nodes.
 
 ```typescript
 type Span = [Path, Path]