Generate dist script file usage with a cdn and the subresource integrity hash

Add docs.
Add version back into the title
Add in explainer for CDN to README and overview
Remove spaces from test

Signed-off-by: Mary Anthony <[email protected]>

Author: zone117x

README.md

@@ -2,21 +2,25 @@
 
 Note: If you're looking for the Blockstack CLI repo it was merged with [Blockstack Core](https://github.com/blockstack/blockstack-core).
 
--   [Installation](#installation)
--   [About](#about)
--   [Auth](https://blockstack.github.io/blockstack.js/index.html#authentication)
--   [Profiles](https://blockstack.github.io/blockstack.js/index.html#profiles)
--   [Storage](https://blockstack.github.io/blockstack.js/index.html#storage)
--   [Documentation](#documentation)
--   [Compatibility](#compatibility)
--   [Contributing](#contributing)
--   [Maintainer](#maintainer)
--   [Testing](#testing)
--   [Releasing](#releasing)
+- [blockstack.js ![CircleCI](https://circleci.com/gh/blockstack/blockstack.js/tree/master) ![npm](https://www.npmjs.com/package/blockstack) ![npm](https://www.npmjs.com/package/blockstack) ![npm](https://www.npmjs.com/package/blockstack) ![Slack](http://slack.blockstack.org/)](#blockstackjs-circlecihttpscirclecicomghblockstackblockstackjstreemaster-npmhttpswwwnpmjscompackageblockstack-npmhttpswwwnpmjscompackageblockstack-npmhttpswwwnpmjscompackageblockstack-slackhttpslackblockstackorg)
+  - [Installation](#installation)
+  - [About](#about)
+  - [Documentation](#documentation)
+  - [Compatibility](#compatibility)
+  - [Contributing](#contributing)
+  - [Maintainer](#maintainer)
+  - [Testing](#testing)
+    - [Testing in a browser](#testing-in-a-browser)
+  - [Releasing](#releasing)
 
 ## Installation
 
-    $ npm install blockstack
+```
+$ npm install blockstack
+```
+
+You can import `blockstack.js` as a script without using a package manager. To securely use the latest distribution of blockstack.js from a CDN, add [this script declaration](mdincludes/include:script-dist-file.md) in your application. 
+
 
 ## About
 

overview.md

@@ -1,4 +1,4 @@
-# blockstack.js Reference Library
+# Using the library
 
 This reference describes the Blockstack Javascript Software Developer Kit (SDK) reference. For complete Blockstack documentation, see [docs.blockstack.org](https://docs.blockstack.org/). There is also reference material available for both the [iOS SDK](https://blockstack.github.io/blockstack-ios/) and [Android SDK](https://blockstack.github.io/blockstack-android/).
 
@@ -9,7 +9,7 @@ This reference describes the Blockstack Javascript Software Developer Kit (SDK)
     $ npm install blockstack
 
 
-## Application Quickstart
+## Quickstart: Build an application
 
 1.  Install `blockstack.js` with `npm`.
 
@@ -81,3 +81,9 @@ This reference describes the Blockstack Javascript Software Developer Kit (SDK)
     can be fetched via an http `GET` from any origin.
 
 7. Serve your application
+
+## Add the library without a package manager
+
+You can import `blockstack.js` as a script without using a package manager. To securely use the latest distribution of `blockstack.js` from a CDN, add the following `script` declaration in your application. 
+
+[[include:script-dist-file.md]]

package.json

@@ -18,7 +18,7 @@
     "dev-proofs": "npm run build:webpack && ts-node ./tests/browserTests/proofs-server.ts",
     "prepublishOnly": "npm run test && npm run build",
     "lint": "eslint --ext .ts ./src",
-    "build-documentation": "shx rm -rf docs && typedoc --tsconfig tsconfig.typedoc.json --out docs src && typedoc --tsconfig tsconfig.typedoc.json --json docs/docs.json src",
+    "build-documentation": "shx rm -rf docs && cross-env typedoc --name \"blockstack.js $npm_package_version Library Reference\" --tsconfig tsconfig.typedoc.json --out docs src && cross-env typedoc --name \"blockstack.js $npm_package_version Library Reference\" --tsconfig tsconfig.typedoc.json --json docs/docs.json src",
     "tsc": "tsc",
     "codecovUpload": "codecov"
   },

tsconfig.typedoc.json

@@ -13,12 +13,12 @@
     "src",
   ],
   "typedocOptions": {
-    "name": "blockstack.js Library Reference",
     "readme": "overview.md",
     "mode": "file",
     "excludePrivate": true,
     "excludeProtected": true,
     "excludeExternals": true,
+    "includes" : "mdincludes"
     "includeDeclarations": false,
     "gitRevision": "master",
     "listInvalidSymbolLinks": true,