Generating API Documentation (#34)

* docs: attempt at generated docs

./node_modules/.bin/documentation build src/index.js --config documentation.yml  -f html -o documentation

* docs: documentationjs works and generates API.md

* docs: decorating all public members with jsdoc comments

Doing this gets them included in the generated API.md documentation.

Also regenerating the API.md doc.

Author: davidjoy

.gitignore

@@ -4,3 +4,4 @@
 coverage
 dist
 node_modules
+/docs/_API-body.md

Makefile

@@ -1,3 +1,8 @@
+# Documentation CLI usage: https://github.com/documentationjs/documentation/blob/master/docs/USAGE.md
+
+doc_command = ./node_modules/.bin/documentation build src -g -c ./docs/documentation.config.yml -f md -o ./docs/_API-body.md --sort-order alpha
+cat_docs_command = cat ./docs/_API-header.md ./docs/_API-body.md > ./docs/API.md
+
 build:
 	rm -rf ./dist
 	./node_modules/.bin/fedx-scripts babel src --out-dir dist --source-maps --ignore **/*.test.jsx,**/*.test.js,**/setupTest.js --copy-files
@@ -7,3 +12,15 @@ build:
 	cp ./package.json ./dist/package.json
 	cp ./LICENSE ./dist/LICENSE
 	cp ./README.md ./dist/README.md
+
+docs-build:
+	${doc_command}
+	${cat_docs_command}
+	rm ./docs/_API-body.md
+
+docs-watch:
+	@echo "NOTE: Please load _API-body.md to see watch results."
+	${doc_command} -w
+
+docs-lint:
+	./node_modules/.bin/documentation lint src