build: check for 404s in the docs (#1562)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -10,7 +10,7 @@ Thanks for stopping by to let us know something could be better!
 
 Please run down the following list and make sure you've tried the usual "quick fixes":
 
-  - Search the issues already opened: https://github.com/google/google-api-nodejs-client/issues
+  - Search the issues already opened: https://github.com/googleapis/google-api-nodejs-client/issues
   - Search the issues on our "catch-all" repository: https://github.com/googleapis/google-cloud-node
   - Search StackOverflow: http://stackoverflow.com/questions/tagged/google-cloud-platform+node.js
 

.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

src/generator/docs.ts

@@ -26,7 +26,12 @@ const writeFile = promisify(fs.writeFile);
 const srcPath = path.join(__dirname, '../../../src');
 const apiPath = path.join(srcPath, 'apis');
 const templatePath = path.join(srcPath, 'generator/templates/index.html.njk');
-const indexPath = path.join(__dirname, '../../../docs/index.html');
+const docsPath = path.join(__dirname, '../../../docs');
+const indexPath = path.join(docsPath, 'index.html');
+
+if (!fs.existsSync(docsPath)) {
+  fs.mkdirSync(docsPath);
+}
 
 /**
  * Iterate over each API directory, and use the `compodoc` tool to generate

synth.metadata

@@ -1,11 +1,11 @@
 {
-  "updateTime": "2018-12-12T12:06:29.527675Z",
+  "updateTime": "2019-01-22T12:06:08.587628Z",
   "sources": [
     {
       "template": {
         "name": "node_library",
         "origin": "synthtool.gcp",
-        "version": "2018.12.6"
+        "version": "2019.1.16"
       }
     }
   ]