[docs] Upgrade documentation to hugo, update quickstart

.buildkite/docs-build-pipeline.yml

@@ -1,6 +1,7 @@
 steps:
   # We add a wait step here so that docker images and docs won't get built
   # unless rest of CI passes.
+  # Currently only exists for operator docs
   - wait
   - name: "Docs build and push :books:"
     command: ".buildkite/scripts/docs_push.sh"

.buildkite/scripts/docs_push.sh

@@ -13,32 +13,6 @@ ssh-keyscan github.com >> "$HOME/.ssh/known_hosts"
 git config --local user.email "[email protected]"
 git config --local user.name "M3 Buildkite Bot"
 
-rm -rf site
-# NB(schallert): if updating this build step or the one below be sure to update
-# the docs-build make target (see note there as to why we can't share code
-# between the two).
-mkdocs build -t material
-mkdocs gh-deploy --force --dirty
-
-# We do two builds to ensure any behavior of gh-deploy doesn't impact the second
-# build.
-rm -rf site
-mkdocs build -t material
-
-git checkout -t origin/docs
-# Trying to commit 0 changes would fail, so let's check if there's any changes
-# between docs branch and our changes.
-if diff -qr site m3db.io; then
-  echo "no docs changes"
-else
-  rm -rf m3db.io/*
-  cp -r site/* m3db.io/
-
-  git add m3db.io
-  git commit -m "Docs update $(date)"
-  git push
-fi
-
 # Also build & push the operator's docs.
 git clean -dffx
 git checkout -t origin/operator

.gitignore

@@ -39,8 +39,6 @@ coverage/
 # Release directory
 dist/
 
-# Docs directory
-site/
 
 # Node
 node_modules/
@@ -60,3 +58,6 @@ m3db.io/openapi
 # Vagrant
 .vagrant
 
+#docs ignores
+site/public
+tmp

.netlify/state.json

@@ -0,0 +1,3 @@
+{
+	"siteId": "b5392a2b-3bc8-44d0-b237-50e5f9b2553e"
+}

Makefile

@@ -94,7 +94,6 @@ TOOLS :=               \
 	verify_data_files    \
 	verify_index_files   \
 	carbon_load          \
-	docs_test            \
 	m3ctl                \
 
 .PHONY: setup
@@ -190,6 +189,7 @@ install-tools:
 	GOBIN=$(tools_bin_path) go install github.com/robskillington/gorename
 	GOBIN=$(tools_bin_path) go install github.com/rakyll/statik
 	GOBIN=$(tools_bin_path) go install github.com/garethr/kubeval
+	GOBIN=$(tools_bin_path) go install github.com/wjdp/htmltest
 
 .PHONY: install-gometalinter
 install-gometalinter:
@@ -214,37 +214,21 @@ release-snapshot: check-for-goreleaser-github-token
 	@echo Creating snapshot release
 	make release GO_RELEASER_RELEASE_ARGS="--snapshot --rm-dist"
 
-.PHONY: docs-container
-docs-container:
-	docker run --rm hello-world >/dev/null
-	docker build -t m3db-docs docs
-
 # NB(schallert): if updating this target, be sure to update the commands used in
 # the .buildkite/docs_push.sh. We can't share the make targets because our
 # Makefile assumes its running under bash and the container is alpine (ash
 # shell).
-.PHONY: docs-build
-docs-build: docs-container
-	docker run -v $(PWD):/m3db --rm m3db-docs "mkdocs build -t material"
-
-.PHONY: docs-serve
-docs-serve: docs-container
-	docker run -v $(PWD):/m3db -p 8000:8000 -it --rm m3db-docs "mkdocs serve -t material -a 0.0.0.0:8000"
-
-.PHONY: docs-deploy
-docs-deploy: docs-container
-	docker run -v $(PWD):/m3db --rm -v $(HOME)/.ssh/id_rsa:/root/.ssh/id_rsa:ro -it m3db-docs "mkdocs build -t material && mkdocs gh-deploy --force --dirty"
-
-.PHONY: docs-validate
-docs-validate: docs_test
-	./bin/docs_test
 
 .PHONY: docs-test
-docs-test:
-	@echo "--- Documentation validate test"
-	make docs-validate
-	@echo "--- Documentation build test"
-	make docs-build
+docs-test: setup install-tools
+	docker run --rm -it -v $(PWD)/site:/src klakegg/hugo:ext-alpine
+	cp site/.htmltest.yml $(BUILD)/.htmltest.yml
+ifneq ($(DOCSTEST_AUTH_USER),)
+ifneq ($(DOCSTEST_AUTH_TOKEN),)
+	@echo 'HTTPHeaders: {"Authorization":"Basic $(shell echo -n "$$DOCSTEST_AUTH_USER:$$DOCSTEST_AUTH_TOKEN" | base64 | xargs echo -n)"}' >> $(BUILD)/.htmltest.yml
+endif
+endif
+	$(tools_bin_path)/htmltest -c $(BUILD)/.htmltest.yml
 
 .PHONY: docker-integration-test
 docker-integration-test: