Docs: Added document generation system

- Docs: Using JSDoc with a modified version of the Braintree
JSDoc Template for generating documentation

- Docs: Improved documentation of Configuration options, other
minor documentation tweaks

- Demo: Added link to generated documentation to demo page

- Scripts: Migrated all project scripts to the ES6 module system
(i.e., using `import` and `export` rather than `module.exports`
and `require`)

- Brat: Renamed file: `ann.js` -> `brat.js`

- Removed old code that has been superseded, added warnings to
old code that is not currently in use

Author: ZechyW

.jsdoc.json

@@ -0,0 +1,19 @@
+{
+  "plugins": [
+    "plugins/markdown"
+  ],
+  "templates": {
+    "referenceTitle": "TextAnnotationGraphs",
+    "disableSort": true,
+    "collapse": false,
+    "resources": {
+      "SVG Path Spec<br>": "https://www.w3.org/TR/SVG/paths.html#PathData",
+      "SVG Cubic Bézier Curve Generator": "https://codepen.io/explosion/pen/YGApwd"
+    }
+  },
+  "opts": {
+    "encoding": "utf8",
+    "recurse": true,
+    "template": "src/jsdoc-template"
+  }
+}

README.md

@@ -1,19 +1,19 @@
 # TextAnnotationGraphs (TAG)
 A modular annotation system that supports complex, interactive annotation graphs embedded on top of sequences of text. An additional view displays a subgraph of selected connections between words/phrases using an interactive network layout.
 
-![TAG](/figs/OneRow.png)
+![TAG](figs/OneRow.png)
 
 ---
 
-![TAG](/figs/taxonomyColors.png)
+![TAG](figs/taxonomyColors.png)
 
 ---
 
-![TAG](/figs/TwoRows.png)
+![TAG](figs/TwoRows.png)
 
 ---
 
-![TAG](/figs/trees.png)
+![TAG](figs/trees.png)
 
 
 ## Development
@@ -93,8 +93,18 @@ Assuming you've cloned the repository, simply run `npm install && npm run build`
 
 ### Live monitoring of changes
 
-For convenience, you can monitor changes to the library's sources (css + js) with the following `npm` task:
+For convenience, you can monitor changes to the library's sources (css + js) with the following `npm` task: 
 
 ```
 npm run watch
 ```
+
+### Generating documentation
+
+TAG uses [JSDoc](http://usejsdoc.org/) to generate its documentation. By default, the documentation is generated using the template in `src/jsdoc-template` (adapted from the [Braintree JSDoc Template](https://github.com/braintree/jsdoc-template)) and stored in the `docs` folder.
+
+To regenerate the documentation, use the following `npm` task:
+
+```
+npm run generate-docs
+``` 

demo/demo.min.js

@@ -23,6 +23,15 @@
 <div class="container py-5">
   <h2 class="mb-5">TextAnnotationGraphs (TAG) Demo</h2>
 
+  <div class="row mb-3">
+    <div class="col">
+      <h4>Documentation</h4>
+      <p>
+        See the API documentation <a href="/docs" target="_blank">here</a>.
+      </p>
+    </div>
+  </div>
+
   <div class="row mb-5">
     <div class="col">
       <h4>Basic example</h4>

demo/index.html

@@ -17,10 +17,11 @@ const app = express();
 const logger = require("morgan");
 app.use(logger("dev"));
 
-// Demo files
-// ----------
+// Demo files and documentation
+// ----------------------------
 app.use(express.static(__dirname));
 app.use("/dist", express.static(path.join(__dirname, "..", "dist")));
+app.use("/docs", express.static(path.join(__dirname, "..", "docs")));
 
 // Set up HTTP interface
 // ---------------------