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

Author: yoshi-automation

.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"
  }
  }
  ]