docs: use typedoc to re-generate ref docs (#1105)

Author: JustinBeckwith

.gitignore

@@ -1,15 +1,12 @@
-node_modules
-.idea
-doc/
+node_modules/
+build/
+docs/
+coverage/
 npm-debug.log
-coverage
-# Empty API
-apis/iam/v1alpha1.js
 .nyc_output
-**/*.js
-**/*.js.map
-!samples/**/*.js
 .vscode
-**/*.d.ts
-**/credentials.json
+.idea
+.DS_Store
 samples/*.keys.json
+samples/**/credentials.json
+

Makefile

@@ -1,4 +1,4 @@
-.PHONY: build build-tools check check-samples check-licenses check-typescript clean coverage docs fix fix-samples fix-typescript generate install test test-samples watch
+.PHONY: build build-tools check check-samples check-licenses check-typescript clean coverage docs fix fix-samples fix-typescript generate install publish-docs test test-samples watch
 
 PATH := $(shell npm bin):$(PATH)
 
@@ -27,7 +27,7 @@ coverage: build
 	nyc report --reporter=html
 
 docs:
-	jsdoc -c jsdoc-conf.json
+	typedoc --out docs src
 
 fix: fix-typescript fix-samples
 
@@ -47,6 +47,9 @@ install:
 node_modules/.link:
 	npm link && npm link googleapis && touch $@
 
+publish-docs:
+	gh-pages --dotfiles --dist docs --remote upstream
+
 test: coverage check
 
 test-samples: node_modules/.link build