Separate documentation dependencies (#874)

* separate documentation dependencies

* bump deps

* update netlify config and package scripts

* bump netlify

* add cross-env

* fix publish path

netlify.toml

@@ -1,27 +1,25 @@
-# Global settings applied to the whole site.
-#
-# “publish” is the directory to publish (relative to root of your repo),
-# “command” is your build command,
+# Settings in the [build] context are global and are applied to all contexts
+# unless otherwise overridden by more specific contexts.
+# @see https://www.netlify.com/docs/netlify-toml-reference/
 [build]
+  base = "docs"
   publish = "docs/.vuepress/dist"
-  command = "rm -rf node_modules && rm -rf package-lock.json && yarn && yarn build:docs"
+  command = "yarn build"
 
 # Deploy Preview context
 #
 # All deploys resulting from a pull/merge request will
 # inherit these settings.
 [context.deploy-preview]
-  publish = "docs/.vuepress/dist"
-  command = "rm -rf node_modules && rm -rf package-lock.json && yarn && yarn build:preview"
+  command = "yarn build:preview"
 
 # Branch Deploy context: all deploys that are not from a pull/merge request or
 # from the Production branch will inherit these settings.
 [context.branch-deploy]
-  base = "/"
-  command = "rm -rf node_modules && rm -rf package-lock.json && yarn && yarn build:preview"
+  command = "yarn build:preview"
 
-# Redirects
-# @see https://www.netlify.com/docs/netlify-toml-reference/
+# Redirects and headers are GLOBAL for all builds – they do not get scoped to
+# contexts no matter where you define them in the file.
 [[redirects]]
   from = "/guide/templating.html"
   to = "/guide/slots.html"