build: check broken links in generated docs

.jsdoc.js

@@ -20,7 +20,7 @@ module.exports = {
   opts: {
     readme: './README.md',
     package: './package.json',
-    template: './node_modules/ink-docstrap/template',
+    template: './node_modules/jsdoc-baseline',
     recurse: true,
     verbose: true,
     destination: './docs/'

.kokoro/docs.sh

@@ -23,3 +23,11 @@ cd $(dirname $0)/..
 npm install
 
 npm run docs
+
+# Check broken links
+BIN=./node_modules/.bin
+
+npm install broken-link-checker
+npm install http-server
+$BIN/http-server -p 8080 docs/ &
+$BIN/blc -r http://localhost:8080

package.json

@@ -55,7 +55,7 @@
     "eslint-config-prettier": "^3.0.0",
     "eslint-plugin-node": "^8.0.0",
     "eslint-plugin-prettier": "^3.0.0",
-    "ink-docstrap": "^1.3.2",
+    "jsdoc-baseline": "git+https://github.com/hegemonic/jsdoc-baseline.git",
     "intelli-espower-loader": "^1.0.1",
     "jsdoc": "^3.5.5",
     "mocha": "^5.2.0",

src/index.js

@@ -36,6 +36,9 @@
 /**
  * @namespace google.rpc
  */
+/**
+ * @namespace google.longrunning
+ */
 
 'use strict';
 

src/v1/doc/google/cloud/speech/v1/doc_cloud_speech.js

@@ -689,4 +689,4 @@ const SpeechRecognitionAlternative = {
  */
 const WordInfo = {
   // This is for documentation. Actual contents will be loaded by gRPC.
-};
+};