various doc-related fixes (#3790)

- ensure `.html` gets hit by prettier
- fix order in which docs are generated; let assetgraph process API docs
- some auto-generated content in `docs/index.md` updated

.lintstagedrc.json

@@ -1,7 +1,10 @@
 {
   "linters": {
     "(bin/*|*.js|**/*.js)": ["eslint --fix", "git add"],
-    "(*.{json,yml,md}|**/*.{json,yml,md})": ["prettier --write", "git add"]
+    "(*.{json,yml,md,html}|**/*.{json,yml,md,html})": [
+      "prettier --write",
+      "git add"
+    ]
   },
   "ignore": ["docs/**/*.js", "test/**/*.fixture.js", "package*.json"]
 }

docs/index.md

@@ -883,7 +883,7 @@ Test Filters
 
 Positional Arguments
   spec  One or more files, directories, or globs to test
-                                                    [array] [default: ["test/"]]
+                                                     [array] [default: ["test"]]
 
 Other Options
   --help, -h     Show usage information & exit                         [boolean]

jsdoc.conf.json

@@ -8,7 +8,7 @@
     "static": false
   },
   "opts": {
-    "destination": "docs/_dist/api",
+    "destination": "docs/_site/api",
     "encoding": "utf8",
     "recurse": true,
     "template": "node_modules/@mocha/docdash",

package-scripts.js

@@ -266,7 +266,7 @@ module.exports = {
     docs: {
       default: {
         script:
-          'nps docs.prebuild && eleventy && nps docs.postbuild && nps docs.api',
+          'nps docs.prebuild && nps docs.api && eleventy && nps docs.postbuild',
         description: 'Build documentation'
       },
       prebuild: {
@@ -299,8 +299,7 @@ module.exports = {
         description: 'Watch docs for changes & build'
       },
       api: {
-        script:
-          'nps docs.preprocess.api && jsdoc -c jsdoc.conf.json && cp LICENSE docs/_dist/api',
+        script: 'nps docs.preprocess.api && jsdoc -c jsdoc.conf.json',
         description: 'Build API docs'
       }
     },