From e4e4cc37d1a6a5d27237f7293803851e11976c7a Mon Sep 17 00:00:00 2001
From: Jan Poeschko <jpoeschko@wolfram.com>
Date: Thu, 25 Jul 2019 13:31:33 +0200
Subject: [PATCH] DQA changes

---
 README.md                     |  24 +++---
 docs/Development.md           |   6 +-
 docs/GettingStarted.md        |  12 +--
 docs/LibraryInterface.md      |  10 +--
 docs/NotebookAPI.md           | 150 +++++++++++++++++-----------------
 docs/NotebookLoadingPhases.md |  12 +--
 docs/ServerSideRendering.md   |  16 ++--
 docs/Troubleshooting.md       |   6 +-
 website/pages/en/index.js     |  10 +--
 website/siteConfig.js         |   2 +-
 10 files changed, 122 insertions(+), 126 deletions(-)

diff --git a/README.md b/README.md
index f431ba1..7592a23 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
 # wolfram-notebook-embedder
 
-A library to embed [Wolfram Cloud](https://www.wolframcloud.com/) notebooks on other sites. It does *not* use an `<iframe>` but renders a notebook directly into a given DOM node, for a more seamless experience.
+A library to embed [Wolfram Cloud](https://www.wolframcloud.com/) notebooks on other sites. It does *not* use an `<iframe>`, but renders a notebook directly into a given DOM node for a more seamless experience.
 
 ## Installation
 
-If you're using a package manager such as [npm](https://www.npmjs.com/get-npm) or [Yarn](https://yarnpkg.com/en/), you can install this package from the npm repository:
+If you are using a package manager such as [npm](https://www.npmjs.com/get-npm) or [Yarn](https://yarnpkg.com/en/), you can install this package from the npm repository:
 
     npm install wolfram-notebook-embedder
     
@@ -20,23 +20,23 @@ and then use the global variable `WolframNotebookEmbedder`.
 
 ## Usage & Documentation
 
-* [**Getting started**](./docs/GettingStarted.md)
-* [Library interface](./docs/LibraryInterface.md)
+* [**Getting Started**](./docs/GettingStarted.md)
+* [Library Interface](./docs/LibraryInterface.md)
 * [Notebook API](./docs/NotebookAPI.md)
-* [Server-side rendering](./docs/ServerSideRendering.md)
-* [Notebook loading phases](./docs/NotebookLoadingPhases.md)
+* [Server-Side Rendering](./docs/ServerSideRendering.md)
+* [Notebook Loading Phases](./docs/NotebookLoadingPhases.md)
 * [Troubleshooting](./docs/Troubleshooting.md)
 
 ## Examples
 
-* [Basic example](./examples/basic.html)
-* [Manipulate example](./examples/manipulate.html)
-* [Dimensions examples](./examples/dimensions.html)
-* [Server-side rendering](./examples/ssr.html)
+* [Basic Example](./examples/basic.html)
+* [Manipulate Example](./examples/manipulate.html)
+* [Dimensions Examples](./examples/dimensions.html)
+* [Server-Side Rendering](./examples/ssr.html)
 
 ## Browser Support
 
-We support all modern browsers (the last 2 major versions of Chrome, Firefox, Edge, Safari), and Internet Explorer 11. Particularly for IE 11, this library includes an internal "ponyfill" for `Promise`, since this library's API heavily depends on promises.
+We support all modern browsers (the last two major versions of Chrome, Firefox, Edge, Safari) and Internet Explorer 11. Particularly for IE 11, this library includes an internal "ponyfill" for `Promise`, since this library's API heavily depends on promises.
 
 ## Contributing
 
@@ -46,7 +46,7 @@ Everyone is welcome to contribute. Please read the [Contributing guide](CONTRIBU
 
 We use [semantic versioning](https://semver.org/) for this library and its API.
 
-Each version of this library is compatible with a certain range of versions of Wolfram Cloud. Currently, the requirement is Wolfram Cloud 1.50 (which is not released yet) or higher. We try hard not to make any backward-incompatible changes on the Wolfram Cloud side, which would require an update of this library to keep embeddings working.
+Each version of this library is compatible with a certain range of versions of the Wolfram Cloud. Currently, the requirement is Wolfram Cloud 1.50 (which has not been released yet) or higher. We try hard not to make any backward-incompatible changes on the Wolfram Cloud side, which would require an update of this library to keep embeddings working.
 
 ## License
 
diff --git a/docs/Development.md b/docs/Development.md
index 1e2768b..777c503 100644
--- a/docs/Development.md
+++ b/docs/Development.md
@@ -3,7 +3,7 @@ id: Development
 title: Development
 ---
 
-Please read the [Contributing guide](https://github.com/WolframResearch/wolfram-notebook-embedder/CONTRIBUTING.md) first. By contributing to this repository, you agree to the licensing terms therein.
+Please read the [Contributing guide](https://github.com/WolframResearch/wolfram-notebook-embedder/CONTRIBUTING.md) first. By contributing to this repository, you agree to the licensing terms herein.
 
 To install all required dependencies for development of this library, run:
 
@@ -15,7 +15,7 @@ To manually test embedded notebooks, run
 
     yarn run-examples
     
-and visit the resulting localhost URL (usually [http://localhost:5000](http://localhost:5000)). On that page, you can enter the path of a notebook on your localhost cloud to embed it.
+and visit the resulting localhost URL (usually http://localhost:5000). On that page, you can enter the path of a notebook on your localhost cloud to embed it.
 
 ## Documentation
 
@@ -51,6 +51,6 @@ Then run
     
 which asks for the new package version, updates `package.json` accordingly, runs a build, creates a Git tag, and publishes the package.
 
-If publishing fails due to missing authentication even though you have run `yarn login`, you might have to delete `~/.npmrc` and log in again (see [this yarn issue](https://github.com/yarnpkg/yarn/issues/4709)).
+If publishing fails due to missing authentication even though you have run `yarn login`, you might have to delete `~/.npmrc` and log in again (see [this Yarn issue](https://github.com/yarnpkg/yarn/issues/4709)).
 
 If [two-factor authentication](https://docs.npmjs.com/configuring-two-factor-authentication) is enabled for your account, you will be asked for a one-time password during the publishing process.
diff --git a/docs/GettingStarted.md b/docs/GettingStarted.md
index 9092859..a8684ca 100644
--- a/docs/GettingStarted.md
+++ b/docs/GettingStarted.md
@@ -4,14 +4,14 @@ title: Getting Started
 ---
 
 1. Create a notebook in the [Wolfram Cloud](https://www.wolframcloud.com/) and make it public.
-    * In the Cloud UI, use the "New Notebook" button and then use the "Share" dialog to make it public.
-    * From the Wolfram Language, you could deploy notebook content like so:
+    * In the cloud UI, use the New Notebook button and then use the Share dialog to make it public.
+    * From the [Wolfram Language](https://www.wolfram.com/language/), you could deploy notebook content like so:
 
         ```mathematica
         CloudDeploy[Manipulate[Plot[Sin[a * x], {x, 0, 2Pi}], {a, 1, 3}],
             Permissions -> {All -> {"Read", "Interact"}}]
         ```
-2. Install this library in your JS project using
+2. Install this library in your JavaScript project using
 
     ```bash
     npm install wolfram-notebook-embedder
@@ -28,14 +28,14 @@ title: Getting Started
     ```html
     <script crossorigin src="https://unpkg.com/wolfram-notebook-embedder@0.1/dist/wolfram-notebook-embedder.min.js"></script>
     ```
-3. In your HTML, create a container where you want the notebook to be rendered (let's say `<div id="notebookContainer"></div>`) and add the following JS code:
+3. In your HTML, create a container where you want the notebook to be rendered (say `<div id="notebookContainer"></div>`) and add the following JS code:
 
     ```js
     var embedding = WolframNotebookEmbedder.embed('url', document.getElementById('notebookContainer'));
     ```
     
     where `url` is the URL of your cloud object from step 1. More details about `embed` are described in the [library interface documentation](./LibraryInterface.md).
-4. If you want to control the notebook from your JS code, wait for the `embed` result (a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises)) to resolve and then use various [Notebook API methods](./NotebookAPI.md):
+4. If you want to control the notebook from your JS code, wait for the `embed` result (a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises)) to resolve, and then use various [Notebook API methods](./NotebookAPI.md):
 
     ```js
     embedding.then(function (nb) {
@@ -51,4 +51,4 @@ title: Getting Started
     })
     ```
 5. If you want to serve static HTML from your server so the notebook can be rendered before JS code is loaded (which also helps with SEO), take a look at [server-side rendering](./ServerSideRendering.md).
-6. If you run into any issues, take a look at the [Troubleshooting guide](./Troubleshooting.md). If you think you found a bug, please report it.
+6. If you run into any issues, take a look at the [troubleshooting guide](./Troubleshooting.md). If you think you found a bug, please report it.
diff --git a/docs/LibraryInterface.md b/docs/LibraryInterface.md
index 3ff0624..a40b3b9 100644
--- a/docs/LibraryInterface.md
+++ b/docs/LibraryInterface.md
@@ -9,8 +9,8 @@ This library exposes a single function `embed` that renders a notebook into a gi
 WolframNotebookEmbedder.embed(notebookURL, domNode, attributes)
 ```
 
-* `notebookURL`: string with a cloud object URL of the notebook to embed, e.g. `'https://www.wolframcloud.com/obj/4beadfbb-84dd-4b26-87b6-bcd30b9abd65'` or `'https://www.wolframcloud.com/obj/myusername/myfolder/mynotebook.nb'`
-* `domNode`: a DOM node to render the notebook in, e.g. obtained by `document.getElementById('myContainer')`
+* `notebookURL`: a string with a cloud object URL of the notebook to embed, e.g. `'https://www.wolframcloud.com/obj/4beadfbb-84dd-4b26-87b6-bcd30b9abd65'` or `'https://www.wolframcloud.com/obj/myusername/myfolder/mynotebook.nb'`
+* `domNode`: a DOM node in which to render the notebook, e.g. obtained by `document.getElementById('myContainer')`
 * `attributes `: a JS object with attributes
 
 The following attributes can be given:
@@ -20,11 +20,11 @@ The following attributes can be given:
 * `allowInteract`: whether to enable interactivity in the notebook, which might use the server-side Wolfram Engine for computations; even if this is set to `true` (the default), the `Permissions` of the cloud notebook must also include `All -> {"React", "Interact"}` for interactions to actually work
 * `showRenderProgress`: whether to show the render progress indicator at the top of the notebook during the initial loading phase (see [Notebook Loading Phases](./NotebookLoadingPhases.md) for more information); the default is `true`
 
-If the notebook exceeds the given width or height, scrollbars are introduced in that dimension. The default dimensions (`width: null`, `maxHeight: Infinity`) let the notebook adapt to the container node's width (line-wrapping as necessary) and make the container node grow vertically as necessary; so there won't be a vertical scrollbar, and there will only be a horizontal scrollbar if the notebook's contents are inherently wider than the available width (e.g. a graphic with a fixed size). In the case of `maxHeight: null`, the notebook's background will fill out the whole container node even if the notebook content is smaller. See also the [Dimensions examples](../examples/dimensions.html).
+If the notebook exceeds the given width or height, scrollbars are introduced in that dimension. The default dimensions (`width: null`, `maxHeight: Infinity`) let the notebook adapt to the container node's width (line-wrapping as necessary) and make the container node grow vertically as necessary, so there won't be a vertical scrollbar, and there will only be a horizontal scrollbar if the notebook's contents are inherently wider than the available width (e.g. a graphic with a fixed size). In the case of `maxHeight: null`, the notebook's background will fill out the whole container node even if the notebook content is smaller.
 
 The embedded notebook needs to be public (i.e. with [Permissions](https://reference.wolfram.com/language/ref/Permissions.html) of at least `All->"Read"`). For interactivity to work, the `"Interact"` permission is needed.
 
-Notebooks on an [Enterprise Private Cloud](https://www.wolfram.com/enterprise-private-cloud/) can be embedded as well, as long as they are public. Just use the cloud object URL pointing to your EPC as the `notebookURL`.
+Notebooks on [Wolfram Enterprise Private Cloud (EPC)](https://www.wolfram.com/enterprise-private-cloud/) can be embedded as well, as long as they are public. Just use the cloud object URL pointing to your EPC as the `notebookURL`.
 
 The function `embed` returns a `Promise` resolving to an object with various methods to control the notebook, e.g.:
 
@@ -34,6 +34,6 @@ The function `embed` returns a `Promise` resolving to an object with various met
 * `removeEventListener(eventName, callback)`: unregisters an event listener
 * many other notebook-related functions, e.g. `getDimensions()`, `getCells()`, `evaluateExpression(expr)`
 
-See the [Notebook API documentation](./NotebookAPI.md) for more details about these methods.
+See the [notebook API documentation](./NotebookAPI.md) for more details about these methods.
 
 If something goes wrong while loading the notebook (e.g. because there is no notebook at the given `notebookURL`), the returned promise is rejected.
diff --git a/docs/NotebookAPI.md b/docs/NotebookAPI.md
index c174326..2454689 100644
--- a/docs/NotebookAPI.md
+++ b/docs/NotebookAPI.md
@@ -18,15 +18,15 @@ Gets the textual content of a cell.
 
 + Parameters
 
-    + `cellId` (`string`) ... ID of the cell to read.
+    + `cellId` (`string`) — ID of the cell to read.
 
 + Response
 
-    + `content` (`string`) ... The textual content of the cell.
+    + `content` (`string`) — The textual content of the cell.
 
 + Errors
 
-    + `"CellNotFound"` ... The cell ID given by `cellId` was not found.
+    + `"CellNotFound"` — The cell ID given by `cellId` was not found.
 
 ### Structure
 
@@ -36,17 +36,17 @@ Retrieves the (top-level) elements in the notebook or a cell group.
 
 + Parameters
 
-    + `groupId` (`?string`) ... ID of the cell group. If the parameter is omitted or falsy (e.g. `null` or `""`), the top-level elements in the notebook are returned.
+    + `groupId` (`?string`) — ID of the cell group. If the parameter is omitted or falsy (e.g. `null` or `""`), the top-level elements in the notebook are returned.
 
 + Response
 
-    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) ... List of elements in the cell group, in the order they appear in the notebook.
-    + `isClosed` (`boolean`) ... Whether the cell group is closed.
-    + `visibleElementIndex` (`?number`) ... Index (0-based) of the visible element in case the cell group is closed. `null` if the group is not closed.
+    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) — List of elements in the cell group, in the order they appear in the notebook.
+    + `isClosed` (`boolean`) — Whether the cell group is closed.
+    + `visibleElementIndex` (`?number`) — Index (0-based) of the visible element in case the cell group is closed. `null` if the group is not closed.
 
 + Errors
 
-    + `"GroupNotFound"` ... The group specified by `groupId` was not found.
+    + `"GroupNotFound"` — The group specified by `groupId` was not found.
 
 Example request:
 
@@ -78,15 +78,15 @@ Retrieves the parent cell group of a given cell or cell group.
 
 + Parameters
 
-    + `id` (`string`) ... ID of the cell or cell group.
+    + `id` (`string`) — ID of the cell or cell group.
 
 + Response
 
-    + `groupId` (`?string`) ... ID of the group the given element is contained in. `null` if the element is in no group (i.e. it is on the top level of a notebook).
+    + `groupId` (`?string`) — ID of the group the given element is contained in. `null` if the element is in no group (i.e. it is on the top level of a notebook).
 
 + Errors
 
-    + `"ElementNotFound"` ... The element specified by `id` was not found.
+    + `"ElementNotFound"` — The element specified by `id` was not found.
 
 #### getCells
 
@@ -94,15 +94,15 @@ Retrieves all (potentially nested) cells in the notebook or a cell group.
 
 + Parameters
 
-    + `groupId` (`?string`) ... ID of the cell group. If the parameter is omitted or falsy (e.g. `null` or `""`), the cells in the notebook are returned.
+    + `groupId` (`?string`) — ID of the cell group. If the parameter is omitted or falsy (e.g. `null` or `""`), the cells in the notebook are returned.
 
 + Response
 
-    + `cells` (`Array.<{type: "cell", id: string}>`) ... List of cells in the order they appear in the notebook.
+    + `cells` (`Array.<{type: "cell", id: string}>`) — List of cells in the order they appear in the notebook.
 
 + Errors
 
-    + `"GroupNotFound"` ... The group specified by `groupId` was not found.
+    + `"GroupNotFound"` — The group specified by `groupId` was not found.
 
 #### openGroup
 
@@ -110,11 +110,11 @@ Opens a cell group. If a group is already open, this has no effect.
 
 + Parameters
 
-    + `groupId` (`string`) ... ID of the cell group.
+    + `groupId` (`string`) — ID of the cell group.
 
 + Errors
 
-    + `"GroupNotFound"` ... The group specified by `groupId` was not found.
+    + `"GroupNotFound"` — The group specified by `groupId` was not found.
 
 #### closeGroup
 
@@ -122,12 +122,12 @@ Closes a cell group, only displaying one of its elements.
 
 + Parameters
 
-    + `groupId` (`string`) ... ID of the cell group.
-    + `visibleElementIndex` (`?number`) ... Index (0-based) of the remaining visible element. If not specified, the first element is chosen ("forward-close"); unless if there is a whole-cell group opener cell in the group, in which case that cell is chosen. If less than 0, the first element is chosen. If greater than or equal to the total number of elements in the group, the last element is chosen ("reverse-close").
+    + `groupId` (`string`) — ID of the cell group.
+    + `visibleElementIndex` (`?number`) — Index (0-based) of the remaining visible element. If not specified, the first element is chosen ("forward-close"); unless if there is a whole-cell group opener cell in the group, in which case that cell is chosen. If less than 0, the first element is chosen. If greater than or equal to the total number of elements in the group, the last element is chosen ("reverse-close").
 
 + Errors
 
-    + `"GroupNotFound"` ... The group specified by `groupId` was not found.
+    + `"GroupNotFound"` — The group specified by `groupId` was not found.
 
 ### Notebook options
 
@@ -137,7 +137,7 @@ Sets outer options to be applied to the notebook. Currently, only the `"Magnific
 
 + Parameters
 
-    + `options` (`Object.<string, string|number>`) ... Dictionary of option names and their respective values.
+    + `options` (`Object.<string, string|number>`) — Dictionary of option names and their respective values.
 
 Example request:
 
@@ -168,12 +168,12 @@ Gets the value of an outer option. Currently, only the `"Magnification"` option
 
 + Parameters
 
-    + `option` (`string`) ... Option name.
+    + `option` (`string`) — Option name.
 
 + Response
 
-    + `option` (`string`) ... Option name.
-    + `value` (`?string|number`) ... Option value. Might be `null` if no explicit value is set.
+    + `option` (`string`) — Option name.
+    + `value` (`?string|number`) — Option value. Might be `null` if no explicit value is set.
 
 Example request:
 
@@ -206,10 +206,10 @@ Gets information about the current selection.
 
 + Response
 
-    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) ... List of elements (cells or cell groups) selected via their cell bracket. Empty array if no cell brackets are selected.
-    + `separator` (`?{cellBefore: ?{cellId: string}, cellAfter: ?{cellId: string}}`) ... If the selection is between cells, this gives the cell before and the cell after the separator. Either of them or `separator` itself can be `null`.
-    + `inCell` (`?{cellId: string}`) ... The cell the selection is inside (i.e. on the box level), if any. This is particularly the case when editing a cell. If the selection is on the cell (bracket) level, `inCell` is `null`.
-    + `cursorPosition` (`?{left: number, top: number}`) ... Cursor position, if a cell is edited. The position is relative to the document offset. This takes into account the scroll position.
+    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) — List of elements (cells or cell groups) selected via their cell bracket. Empty array if no cell brackets are selected.
+    + `separator` (`?{cellBefore: ?{cellId: string}, cellAfter: ?{cellId: string}}`) — If the selection is between cells, this gives the cell before and the cell after the separator. Either of them or `separator` itself can be `null`.
+    + `inCell` (`?{cellId: string}`) — The cell the selection is inside (i.e. on the box level), if any. This is particularly the case when editing a cell. If the selection is on the cell (bracket) level, `inCell` is `null`.
+    + `cursorPosition` (`?{left: number, top: number}`) — Cursor position, if a cell is edited. The position is relative to the document offset. This takes into account the scroll position.
 
 Example request:
 
@@ -240,11 +240,11 @@ Selects elements (cell brackets).
 
 + Parameters
 
-    + `elements` (`Array.<{id: string}>`) ... List of IDs of elements to select. Elements that cannot be found are ignored.
+    + `elements` (`Array.<{id: string}>`) — List of IDs of elements to select. Elements that cannot be found are ignored.
 
 + Response
 
-    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) ... List of elements that have been found and are selected now.
+    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) — List of elements that have been found and are selected now.
 
 
 #### selectSeparatorBeforeElement
@@ -253,7 +253,7 @@ Moves the selection to the separator before a cell or cell group.
 
 + Parameters
 
-    + `id` (`?string`) ... ID of the element before which the separator should be. If `null`, the selection is moved to the end of the notebook.
+    + `id` (`?string`) — ID of the element before which the separator should be. If `null`, the selection is moved to the end of the notebook.
 
 + Errors
 
@@ -265,7 +265,7 @@ Moves the selection to the separator after a cell or cell group.
 
 + Parameters
 
-    + `id` (`?string`) ... ID of the element after which the separator should be. If `null`, the selection is moved to the beginning of the notebook.
+    + `id` (`?string`) — ID of the element after which the separator should be. If `null`, the selection is moved to the beginning of the notebook.
 
 + Errors
 
@@ -279,8 +279,8 @@ Returns the dimensions of the notebook content.
 
 + Response
 
-    + `width` (`number`) ... The width of the notebook content (in pixels). Note that a notebook will always fill any available (maximum) width. If there is a horizontal scrollbar, the reported width may be larger than the maximum width available to the notebook. Providing the reported width as horizontal space to the notebook usually ensures that there is no horizontal scrollbar necessary.
-    + `height` (`number`) ... The height of the notebook content (in pixels). This does not include any unused vertical space that would be available to the notebook. It does include the height of the horizontal scrollbar, in case there is one. Providing the reported height as vertical space to the notebook usually ensures that there is no vertical scrollbar necessary.
+    + `width` (`number`) — The width of the notebook content (in pixels). Note that a notebook will always fill any available (maximum) width. If there is a horizontal scrollbar, the reported width may be larger than the maximum width available to the notebook. Providing the reported width as horizontal space to the notebook usually ensures that there is no horizontal scrollbar necessary.
+    + `height` (`number`) — The height of the notebook content (in pixels). This does not include any unused vertical space that would be available to the notebook. It does include the height of the horizontal scrollbar, in case there is one. Providing the reported height as vertical space to the notebook usually ensures that there is no vertical scrollbar necessary.
 
 ### Scrolling
 
@@ -290,8 +290,8 @@ Returns the current scroll position in the notebook.
 
 + Response
 
-    + `left` (`number`) ... Number of pixels scrolled in horizontal direction (increases when scrolling to the right).
-    + `top` (`number`) ... Number of pixels scrolled in vertical direction (increases when scrolling down).
+    + `left` (`number`) — Number of pixels scrolled in horizontal direction (increases when scrolling to the right).
+    + `top` (`number`) — Number of pixels scrolled in vertical direction (increases when scrolling down).
 
 #### setScrollPosition
 
@@ -299,29 +299,29 @@ Scrolls to the specified position in the notebook.
 
 + Parameters
 
-    + `left` (`number`) ... Number of pixels to scroll to in horizontal direction (increases when scrolling to the right).
-    + `top` (`number`) ... Number of pixels to scroll to in vertical direction (increases when scrolling down).
+    + `left` (`number`) — Number of pixels to scroll to in horizontal direction (increases when scrolling to the right).
+    + `top` (`number`) — Number of pixels to scroll to in vertical direction (increases when scrolling down).
 
 ### Evaluation
 
 #### evaluateExpression
 
-Evaluates a WL expression.
+Evaluates a Wolfram Language expression.
 
 The API responds with the resulting expression when the evaluation is finished.
 
 + Parameters
 
-    + `expression` (`string`) ... WL expression to evaluate.
-    + `originatingCellId` = `null` (optional, `?string`) ... ID of the cell the evaluation is supposed to be originating from (for the purpose of `EvaluationCell[]`).
+    + `expression` (`string`) — Wolfram Language expression to evaluate.
+    + `originatingCellId` = `null` (optional, `?string`) — ID of the cell the evaluation is supposed to be originating from (for the purpose of `EvaluationCell[]`).
 
 + Response
 
-    + `result` ... The result of the evaluation in JSON expression representation (see below).
+    + `result` — The result of the evaluation in JSON expression representation (see below).
 
 + Errors
 
-    + `"EvaluationError"` ... There was some error during the evaluation, e.g. the kernel was not reachable.
+    + `"EvaluationError"` — There was some error during the evaluation, e.g. the kernel was not reachable.
     + `"InsufficientPermissions"`
 
 Example request:
@@ -350,18 +350,18 @@ Retrieves the value of a DynamicModule variable.
 
 + Parameters
 
-    + `cellId` (`string`) ... ID of the cell that contains the DynamicModuleBox. If the cell contains multiple DynamicModuleBoxes, the first DynamicModuleBox in a breadth-first search is chosen.
-    + `name` (`string`) ... Name of the DynamicModule variable to retrieve.
+    + `cellId` (`string`) — ID of the cell that contains the DynamicModuleBox. If the cell contains multiple DynamicModuleBoxes, the first DynamicModuleBox in a breadth-first search is chosen.
+    + `name` (`string`) — Name of the DynamicModule variable to retrieve.
 
 + Response
 
-    + `value` ... The value of the variable in JSON expression representation (see below).
+    + `value` — The value of the variable in JSON expression representation (see below).
 
 + Errors
 
-    + `"CellNotFound"` ... The specified cell does not exist.
-    + `"NoDynamicModule"` ... There is no DynamicModuleBox in the specified cell.
-    + `"UnknownVariableName"`" ... The DynamicModuleBox does not contain the specified variable.
+    + `"CellNotFound"` — The specified cell does not exist.
+    + `"NoDynamicModule"` — There is no DynamicModuleBox in the specified cell.
+    + `"UnknownVariableName"` — The DynamicModuleBox does not contain the specified variable.
 
 #### setDynamicModuleVariable
 
@@ -369,15 +369,15 @@ Sets the value of a DynamicModule variable.
 
 + Parameters
 
-    + `cellId` (`string`) ... ID of the cell that contains the DynamicModuleBox. If the cell contains multiple DynamicModuleBoxes, the first DynamicModuleBox in a breadth-first search is chosen.
-    + `name` (`string`) ... Name of the DynamicModule variable to change.
-    + `value` ... The new value of the variable in JSON expression representation (see below).
+    + `cellId` (`string`) — ID of the cell that contains the DynamicModuleBox. If the cell contains multiple DynamicModuleBoxes, the first DynamicModuleBox in a breadth-first search is chosen.
+    + `name` (`string`) — Name of the DynamicModule variable to change.
+    + `value` — The new value of the variable in JSON expression representation (see below).
 
 + Errors
 
-    + `"CellNotFound"` ... The specified cell does not exist.
-    + `"NoDynamicModule"` ... There is no DynamicModuleBox in the specified cell.
-    + `"UnknownVariableName"`" ... The DynamicModuleBox does not contain the specified variable.
+    + `"CellNotFound"` — The specified cell does not exist.
+    + `"NoDynamicModule"` — There is no DynamicModuleBox in the specified cell.
+    + `"UnknownVariableName"` — The DynamicModuleBox does not contain the specified variable.
 
 ### Cell rendering
 
@@ -385,26 +385,26 @@ Sets the value of a DynamicModule variable.
 
 Returns the rendering method (mode) used by a given cell.
 
-Currently there are four different rendering methods, as shown below.
+There are currently four different rendering methods, as shown here.
 
 | Method   | Meaning |
 |----------|---------|
-| `boxes`  | Live-rendered |
-| `static` | Rendered as static html, from the HTML cache |
-| `image`  | Rendered as rasterized image |
-| `none`   | Rendered as a general placeholer |
+| `boxes`  | live-rendered |
+| `static` | rendered as static HTML, from the HTML cache |
+| `image`  | rendered as a rasterized image |
+| `none`   | rendered as a general placeholer |
 
 + Parameters
 
-    + `cellId` (`string`) ... The ID of the cell.
+    + `cellId` (`string`) — The ID of the cell.
 
 + Response
 
-    + `method` (`string`) ... The method used to render the given cell.
+    + `method` (`string`) — The method used to render the given cell.
 
 + Errors
 
-    + `"CellNotFound"` ... The cell ID given by `cellId` was not found.
+    + `"CellNotFound"` — The cell ID given by `cellId` was not found.
 
 ## Events
 
@@ -414,11 +414,11 @@ See [notebook loading phases](./NotebookLoadingPhases.md) for more information.
 
 #### first-paint-done (singular)
 
-Fired when either static HTML is shown for the notebook (see [servers-side rendering](./ServerSideRendering.md)) or the notebook starts rendering individual cells.
+Fired when either static HTML is shown for the notebook (see [Server-Side Rendering](./ServerSideRendering.md)) or the notebook starts rendering individual cells.
 
 + Fields
 
-    + `showingStaticHTML` (`boolean`) ... Whether the notebook is showing a piece of static HTML.
+    + `showingStaticHTML` (`boolean`) — Whether the notebook is showing a piece of static HTML.
 
 #### initial-render-progress
 
@@ -426,8 +426,8 @@ Fired when progress is made during the initial render phase.
 
 + Fields
 
-    + `cellsRendered` (`number`) ... Number of cells that have already been "live-rendered".
-    + `cellsTotal` (`number`) ... Total number of cells that are visible in the notebook.
+    + `cellsRendered` (`number`) — Number of cells that have already been "live-rendered".
+    + `cellsTotal` (`number`) — Total number of cells that are visible in the notebook.
 
 #### initial-render-done (singular)
 
@@ -441,9 +441,9 @@ Fired when the notebook selection changes.
 
 + Fields
 
-    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) ... List of elements (cells or cell groups) selected via their cell bracket.
-    + `separator` (`?{cellBefore: ?{cellId: string}, cellAfter: ?{cellId: string}}`) ... If the selection is between cells, this gives the cell before and the cell after the separator.
-    + `inCell` (`?{cellId: string}`) ... The cell the selection is inside (i.e. on the box level), if any. This is particularly the case when editing a cell.
+    + `elements` (`Array.<{type: "cell"|"group", id: string}>`) — List of elements (cells or cell groups) selected via their cell bracket.
+    + `separator` (`?{cellBefore: ?{cellId: string}, cellAfter: ?{cellId: string}}`) — If the selection is between cells, this gives the cell before and the cell after the separator.
+    + `inCell` (`?{cellId: string}`) — The cell the selection is inside (i.e. on the box level), if any. This is particularly the case when editing a cell.
 
 ### Evaluation
 
@@ -455,7 +455,7 @@ Currently, only one kernel evaluation can happen at any time. However, this migh
 
 + Fields
 
-    + `isCellEvaluation` (`boolean`) ... `true` if the evaluation is a whole-cell evaluation (e.g. from pressing Shift-Enter). `false` if the evaluation is triggered by a `Dynamic` or some other dynamic control (e.g. a `Button`).
+    + `isCellEvaluation` (`boolean`) — `true` if the evaluation is a whole-cell evaluation (e.g. from pressing Shift-Enter). `false` if the evaluation is triggered by a `Dynamic` or some other dynamic control (e.g. a `Button`).
 
 #### evaluation-stop
 
@@ -469,16 +469,16 @@ Fired when the notebook dimensions change. See [`getDimensions`](#getdimensions)
 
 + Fields
 
-    + `width` (`number`) ... Width of the notebook content (in pixels).
-    + `height` (`number`) ... Height of the notebook content (in pixels).
+    + `width` (`number`) — Width of the notebook content (in pixels).
+    + `height` (`number`) — Height of the notebook content (in pixels).
 
 ### Scrolling
 
 #### scroll-position-change
 
-Fired when scroll position changes.
+Fired when the scroll position changes.
 
 + Fields (same as `getScrollPosition`)
 
-    + `left` (`number`) ... Number of pixels scrolled in horizontal direction (increases when scrolling to the right).
-    + `top` (`number`) ... Number of pixels scrolled in vertical direction (increases when scrolling down).
+    + `left` (`number`) — Number of pixels scrolled in horizontal direction (increases when scrolling to the right).
+    + `top` (`number`) — Number of pixels scrolled in vertical direction (increases when scrolling down).
diff --git a/docs/NotebookLoadingPhases.md b/docs/NotebookLoadingPhases.md
index e496819..9ea106c 100644
--- a/docs/NotebookLoadingPhases.md
+++ b/docs/NotebookLoadingPhases.md
@@ -5,14 +5,14 @@ title: Notebook Loading Phases
 
 ## Rendering phases
 
-Notebooks depend on various things that are loaded asynchronously, e.g. the actual notebook content, CSS, JS, fonts, and (potentially) results from kernel evaluations. While things are loading, static pieces of HTML are rendered if available (see [server-side rendering](./ServerSideRendering.md)). Rendering generally goes through the following phases:
+Notebooks depend on various things that are loaded asynchronously, e.g. the actual notebook content, CSS, JS, fonts and (potentially) results from kernel evaluations. While things are loading, static pieces of HTML are rendered if available (see [server-side rendering](./ServerSideRendering.md)). Rendering generally goes through the following phases:
 
 1. Nothing is displayed initially.
 2. Once critical CSS and fonts are loaded: Static HTML is displayed, if available; the event `first-paint-done` with `{showingStaticHTML: true}` is fired.
 3. Once the main JS code and notebook content data is loaded: Static HTML is reused as a whole (albeit in a slightly different container structure); the event `initial-render-progress` with `{cellsRendered: 0, cellsTotal: -1}` is fired.
-4. Once other dependencies such as the notebook stylesheet is loaded and notebook-level options are resolved (possibly relying on kernel evaluations): Static HTML for individual cells is rendered; the event `initial-render-progress` with `{cellsRendered: 0, cellsTotal: N}` is fired with the actual number `N` of initially visible cells. If no static HTML was available initially, the event `first-paint-done` is fired at this point. The notebook also starts fetching static HTML for cells that were not present in the initial static HTML.
-5. Each cell might require additional dependencies (e.g. fonts), resolution of `Dynamic` option values, or resolution of `Dynamic` content, etc. Once a cell becomes ready, it is "live-rendered", while other non-ready cells are still rendered using static HTML; the event `initial-render-progress` with `{cellsRendered: M, cellsTotal: N}` is fired accordingly.
-6. Once all cells have been live-rendered: the event `initial-render-done` is fired.
+4. Once other dependencies, such as the notebook stylesheet, are loaded and notebook-level options are resolved (possibly relying on kernel evaluations): Static HTML for individual cells is rendered; the event `initial-render-progress` with `{cellsRendered: 0, cellsTotal: N}` is fired with the actual number `N` of initially visible cells. If no static HTML was available initially, the event `first-paint-done` is fired at this point. The notebook also starts fetching static HTML for cells that were not present in the initial static HTML.
+5. Each cell might require additional dependencies (e.g. fonts), resolution of `Dynamic` option values, resolution of `Dynamic` content, etc. Once a cell becomes ready, it is "live-rendered", while other non-ready cells are still rendered using static HTML; the event `initial-render-progress` with `{cellsRendered: M, cellsTotal: N}` is fired accordingly.
+6. Once all cells have been live-rendered: The event `initial-render-done` is fired.
 
 If no static HTML is available for the notebook as a whole or for individual cells, a loading background is displayed in their place until they are live-rendered.
 
@@ -20,7 +20,7 @@ If no static HTML is available for the notebook as a whole or for individual cel
 
 By default, notebooks show a (blue) progress indicator at the top during the initial render phase. It can be turned off by setting the option `showRenderProgress: false`. The progress indicator distinguishes between two groups of phases:
 
-1. (phase 1-3 above) An indeterminate progress indicator is shown.
-2. (phase 4-6 above) A determinate progress indicator is shown, based on the number of rendered vs. total cells, as long as there are at least three cells in the notebook. If there are less then three cells, another indeterminate progress indicator is shown (since a determinate progress indicator would jump too much and not give a real impression of progress).
+1. (Phases 1–3 above.) An indeterminate progress indicator is shown.
+2. (Phases 4–6 above.) A determinate progress indicator is shown, based on the number of rendered vs. total cells, as long as there are at least three cells in the notebook. If there are fewer then three cells, another indeterminate progress indicator is shown (since a determinate progress indicator would jump too much and not give a real impression of progress).
 
 Once the initial render phase is over, the progress indicator is hidden.
diff --git a/docs/ServerSideRendering.md b/docs/ServerSideRendering.md
index d9e99bb..ba6e265 100644
--- a/docs/ServerSideRendering.md
+++ b/docs/ServerSideRendering.md
@@ -3,7 +3,7 @@ id: ServerSideRendering
 title: Server-Side Rendering
 ---
 
-In some cases, you might want to include (static) HTML for a notebook on your page so it can be rendered even before the necessary JavaScript code is loaded and executed. This reduces the time until the user sees the notebook, and it also helps search engines to index your notebook content. Once your JS code executes, you can [embed](./LibraryInterface.md) the notebook into the same container node, and it will transition seamlessly from the static view to "live" (interactive) rendering. The same happens on [wolframcloud.com](https://www.wolframcloud.com) as well.
+In some cases, you might want to include (static) HTML for a notebook on your page so it can be rendered even before the necessary JavaScript code is loaded and executed. This reduces the time until the user sees the notebook, and it also helps search engines to index your notebook content. Once your JS code executes, you can [embed](./LibraryInterface.md) the notebook into the same container node, and it will transition seamlessly from the static view to "live" (interactive) rendering. The same happens on [www.wolframcloud.com](https://www.wolframcloud.com) as well.
 
 Static HTML is generated ("pre-rendered") for each cloud notebook whenever it is created or changed. You can access it through an HTTP API, by making a `GET` request to
 
@@ -15,22 +15,18 @@ This API returns a piece of static HTML that can be included right on your page
 
 ## Waiting for HTML to be available
 
-Sometimes, there might be no HTML for a notebook available yet, e.g. when it has just been edited and the cloud server didn't get a chance to pre-render it yet. In that case, the API will return an empty response. However, you can tell the API to wait up to a certain time and return static HTML once it becomes available. That's what the query parameter `maxwaitmillis` is for. E.g.
+Sometimes, there might be no HTML for a notebook available yet, e.g. when it has just been edited and the cloud server has not had a chance to pre-render it yet. In that case, the API will return an empty response. However, you can tell the API to wait up to a certain time and return static HTML once it becomes available. That's what the query parameter `maxwaitmillis` is for, e.g.
 
     https://www.wolframcloud.com/statichtml/4beadfbb-84dd-4b26-87b6-bcd30b9abd65&maxwaitmillis=500
     
-would wait up to 500 milliseconds in case there is no HTML available yet and return once it becomes available. If the cloud server hasn't finished generating HTML after half a second, the API will return an empty response.
+would wait up to 500 milliseconds in case there is no HTML available yet and return once it becomes available. If the cloud server has not finished generating HTML after half a second, the API will return an empty response.
 
-The maximum accepted value for `maxwaitmillis` is 20,000 (20 seconds). Typically, we recommend using rather low values (not longer than 1 second), since this would delay the initial response from your server (while it's waiting for the cloud server to return HTML) and thus the loading of the whole page.
+The maximum accepted value for `maxwaitmillis` is 20,000 (20 seconds). Typically, using rather low values (not longer than 1 second) is recommended, since this would delay the initial response from your server (while it is waiting for the cloud server to return HTML) and thus the loading of the whole page.
 
 ## Specifying a notebook width
 
-Parts of the static HTML might depend on the page width, e.g. to determine where to line-wrap code cells. Since the page width is not usually known on the server, it can only assume a certain notebook width and return HTML for that, which will cause text to reflow on the client side (once the actual page width is known and "live" rendering kicks in). If you do know the notebook width in advance (e.g. because you're embedding the notebook at a fixed width), you can request HTML for that particular width using the `width` parameter to the API. E.g. 
+Parts of the static HTML might depend on the page width, e.g. to determine where to line-wrap code cells. Since the page width is not usually known on the server, it can only assume a certain notebook width and return HTML for that, which will cause text to reflow on the client side (once the actual page width is known and "live" rendering kicks in). If you do know the notebook width in advance (e.g. because you are embedding the notebook at a fixed width), you can request HTML for that particular width using the `width` parameter to the API, e.g. 
 
     https://www.wolframcloud.com/statichtml/4beadfbb-84dd-4b26-87b6-bcd30b9abd65&width=700
     
-would request HTML for a notebook width of 700 pixels. There's no guarantee that you get HTML for *exactly* that width, but the API will choose the best match out of the available pre-rendered HTML.
-
-## Example
-
-Take a look at the [server-side rendering example](../examples/ssr.html) for how this API can be used in combination with client-side rendering. It is a bit contrived, though, since it fetches the notebook HTML from the client side, whereas this would typically happen on the server side.
+would request HTML for a notebook width of 700 pixels. There is no guarantee that you get HTML for *exactly* that width, but the API will choose the best match out of the available pre-rendered HTML.
diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md
index 9553a30..8cc6235 100644
--- a/docs/Troubleshooting.md
+++ b/docs/Troubleshooting.md
@@ -7,13 +7,13 @@ title: Troubleshooting
 
 **The embedded notebook does not load.**
 
-Please double-check that the embedded cloud notebook is *public*, e.g. by opening its URL in an incognito window of your browser (where you're not logged into the Wolfram Cloud). In the Wolfram Language, you can determine permissions of a cloud object using
+Please double-check that the embedded cloud notebook is *public*, e.g. by opening its URL in an incognito window of your browser (where you are not logged in to the Wolfram Cloud). In the Wolfram Language, you can determine permissions of a cloud object using
 
 ```mathematica
 CloudObjectInformation[CloudObject["..."], "Permissions"]
 ```
     
-and you can make a cloud object public by evaluating:
+and you can make a cloud object public by evaluating the following:
 
 ```mathematica
 SetPermissions[CloudObject["..."], All -> {"Read", "Interact"}]
@@ -27,7 +27,7 @@ This might be a bug in our (notebook) CSS. We try to isolate CSS selectors as mu
 
 **The styling of the notebook seems wrong.**
 
-This could be because your CSS definitions "leak into" the notebook. Since the notebook is just another DOM node on your page, it inherits any global CSS. Try to make your CSS selectors more specific so they don't affect the notebook container node. If isolating styles is a problem, you can always fall back to embedding your cloud notebook using an iframe, e.g.:
+This could be because your CSS definitions "leak into" the notebook. Since the notebook is just another DOM node on your page, it inherits any global CSS. Try to make your CSS selectors more specific so they do not affect the notebook container node. If isolating styles is a problem, you can always fall back to embedding your cloud notebook using an iframe, e.g.:
 
 ```html
 <iframe src="https://www.wolframcloud.com/obj/jpoeschko/Public/Example.nb" width="800" height="600" />
diff --git a/website/pages/en/index.js b/website/pages/en/index.js
index f7d9d9f..0a78f32 100644
--- a/website/pages/en/index.js
+++ b/website/pages/en/index.js
@@ -114,8 +114,8 @@ class Index extends React.Component {
         {[
           {
             content:
-              'Wolfram Notebook Embedder takes a public notebook on the [Wolfram Cloud](https://wwww.wolframcloud.com) and renders it into a given DOM node. ' +
-              'It automatically fetches all required dependencies, such as further scripts, styles, and fonts. ' +
+              'Wolfram Notebook Embedder takes a public notebook in the [Wolfram Cloud](https://wwww.wolframcloud.com) and renders it into a given DOM node. ' +
+              'It automatically fetches all required dependencies, such as further scripts, styles and fonts. ' +
               'The library and any additional notebook resources only need to be fetched, even if you embed multiple notebooks on a single page.',
             image: `${baseUrl}img/undraw_note_list.svg`,
             imageAlign: 'right',
@@ -143,13 +143,13 @@ class Index extends React.Component {
       <Block layout="fourColumn">
         {[
           {
-            content: 'Embed [notebooks](http://www.wolfram.com/notebooks/) on your site more seamlessly than what would be possible with iframes. An embedded notebook\'s dimensions can grow as large as necessary or you can constrain its width and height as you wish.',
+            content: 'Embed [notebooks](http://www.wolfram.com/notebooks/) on your site more seamlessly than what would be possible with iframes. An embedded notebook\'s dimensions can grow as large as necessary, or you can constrain its width and height as you wish.',
             image: `${baseUrl}img/undraw_react.svg`,
             imageAlign: 'top',
             title: 'Seamless Embedding',
           },
           {
-            content: 'Control the notebook through an extensive JavaScript API. For instance, change the value of a Manipulate variable, open and close cell groups, or evaluate [Wolfram Language](https://www.wolfram.com/language/) expressions from your JavaScript code.',
+            content: 'Control the notebook through an extensive JavaScript API. You can, for instance, change the value of a [Manipulate](https://reference.wolfram.com/language/ref/Manipulate.html) variable, open and close cell groups or evaluate [Wolfram Language](https://www.wolfram.com/language/) expressions from your JavaScript code.',
             image: `${baseUrl}img/undraw_operating_system.svg`,
             imageAlign: 'top',
             title: 'Scriptable Control',
@@ -175,7 +175,7 @@ class Index extends React.Component {
 
       return (
         <div className="productShowcaseSection paddingBottom">
-          <h2>Who is Using This?</h2>
+          <h2>Who Is Using This?</h2>
           <p>Notebooks are embedded on all these sites:</p>
           <div className="logos">{showcase}</div>
           <div className="more-users">
diff --git a/website/siteConfig.js b/website/siteConfig.js
index 3fb0389..f2984c9 100644
--- a/website/siteConfig.js
+++ b/website/siteConfig.js
@@ -4,7 +4,7 @@
 // List of projects/orgs using your project for the users page.
 const users = [
   {
-    caption: 'Notebook Archive',
+    caption: 'Wolfram Notebook Archive',
     // You will need to prepend the image path with your baseUrl
     // if it is not '/', like: '/test-site/img/image.jpg'.
     image: '/img/undraw_open_source.svg',