add deploy command & remove unnecessary commands

Author: M00nF1sh

docs.mk

@@ -25,74 +25,50 @@ SERVE_BIND_ADDRESS ?= 127.0.0.1
 TOP := $(dir $(firstword $(MAKEFILE_LIST)))
 # DOCROOT is the root of the mkdocs tree.
 DOCROOT := $(abspath $(TOP))
-# GENROOT is the root of the generated documentation.
-GENROOT := $(DOCROOT)/docs
 
 # Grab the uid/gid to fix permissions due to running in a docker container.
 GID := $(shell id -g)
 UID := $(shell id -u)
 
 # SOURCES is a list of a source files used to generate the documentation.
-SOURCES := $(shell find $(DOCROOT)/docs-src -name \*.md)
+SOURCES := $(shell find $(DOCROOT)/docs -name \*.md)
 SOURCES += mkdocs.yml docs.mk
 
 # entrypoint
-all: .mkdocs.timestamp
+all: 
 
 # Support docker images.
 .PHONY: images
 images: .mkdocs.dockerfile.timestamp
 
 # build the image for mkdocs
-.mkdocs.dockerfile.timestamp: mkdocs.dockerfile
+.mkdocs.dockerfile.timestamp: mkdocs.dockerfile mkdocs.requirements.txt
 	docker build -t $(MKDOCS_IMAGE) -f mkdocs.dockerfile .
 	date > $@
 
-# generate the `docs` from SOURCES
-.mkdocs.timestamp: images $(SOURCES)
+# serve runs mkdocs as a local webserver for interactive development.
+# This will serve the live copy of the docs on 127.0.0.1:8000.
+.PHONY: serve
+serve: images
 	$(DOCKER) run \
-		--mount type=bind,source=$(DOCROOT),target=/d \
+		-it \
 		--sig-proxy=true \
-		--rm \
-		$(MKDOCS_IMAGE) \
-		/bin/bash -c "cd /d && $(MKDOCS) build; find /d/docs -exec chown $(UID):$(GID) {} \;"
-	# Remove sitemap as it contains the timestamp, which is a source of a lot
-	# of merge conflicts.
-	rm docs/sitemap.xml docs/sitemap.xml.gz
-	date > $@
-
-.PHONY: verify
-# verify that the docs have been properly updated.
-#
-# docs-src/.mkdocs-exclude contains a list of `diff -X` files to
-# exclude from the verification diff.
-verify: images
-	$(DOCKER) run \
 		--mount type=bind,source=$(DOCROOT),target=/d \
-		--sig-proxy=true \
+		-p $(SERVE_BIND_ADDRESS):8000:8000 \
 		--rm \
 		$(MKDOCS_IMAGE) \
-		/bin/bash -c "cd /d && $(MKDOCS) build --site-dir=/tmp/d && diff -X /d/docs-src/.mkdocs-exclude -qr /d/docs /tmp/d"
-
-# clean deletes generated files
-.PHONY: clean
-clean:
-	test -f .mkdocs.timestamp && rm .mkdocs.timestamp || true
-	test -f .mkdocs.dockerfile.timestamp && rm .mkdocs.dockerfile.timestamp || true
-	rm -r $(GENROOT)/* || true
+		/bin/bash -c "cd /d && $(MKDOCS) serve -a 0.0.0.0:8000"
 
-# serve runs mkdocs as a local webserver for interactive development.
-# This will serve the live copy of the docs on 127.0.0.1:8000.
-.PHONY: images serve
-serve:
+# deploy will publish generated docs into gh-pages branch.
+.PHONY: deploy
+deploy: images
 	$(DOCKER) run \
 		-it \
 		--sig-proxy=true \
 		--mount type=bind,source=$(DOCROOT),target=/d \
-		-p $(SERVE_BIND_ADDRESS):8000:8000 \
 		--rm \
 		$(MKDOCS_IMAGE) \
-		/bin/bash -c "cd /d && $(MKDOCS) serve -a 0.0.0.0:8000"
+		/bin/bash -c "cd /d && git config --global url."https://$$GITHUB_USER:$$GITHUB_TOKEN@github.com/".pushInsteadOf "https://github.com/" && $(MKDOCS) gh-deploy"
 
 # help prints usage for this Makefile.
 .PHONY: help
@@ -101,8 +77,8 @@ help:
 	@echo ""
 	@echo "make        Build the documentation"
 	@echo "make help   Print this help message"
-	@echo "make clean  Delete generated files"
 	@echo "make serve  Run the webserver for live editing (ctrl-C to quit)"
+	@echo "make deploy Publish generated docs into gh-pages branch"
 
 # init creates a new mkdocs template. This is included for completeness.
 .PHONY: images init
@@ -113,4 +89,3 @@ init:
 		--rm \
 		$(MKDOCS_IMAGE) \
 		/bin/bash -c "$(MKDOCS) new d; find /d -exec chown $(UID):$(GID) {} \;"
-

mkdocs.dockerfile

@@ -16,6 +16,9 @@ FROM alpine:3.11
 COPY mkdocs.requirements.txt /
 RUN apk add -U --no-cache \
     python3 \
+    git \
     bash \
     diffutils \
+    git \
+    git-fast-import \
   && pip3 install -r /mkdocs.requirements.txt

mkdocs.requirements.txt

@@ -1,16 +1,18 @@
 Click==7.0
+future==0.18.2
 htmlmin==0.1.12
-Jinja2==2.10.3
+Jinja2==2.11.1
 jsmin==2.2.2
 livereload==2.6.1
-Markdown==3.1.1
+lunr==0.5.6
+Markdown==3.2.1
 MarkupSafe==1.1.1
-mkdocs==1.0.4
-mkdocs-material==4.6.0
-mkdocs-minify-plugin==0.2.1
-pep562==1.0
+mkdocs==1.1
+mkdocs-material==4.6.3
+mkdocs-minify-plugin==0.2.3
+nltk==3.4.5
 Pygments==2.5.2
-pymdown-extensions==6.2.1
+pymdown-extensions==6.3
 PyYAML==5.3
 six==1.14.0
-tornado==6.0.3
+tornado==6.0.3

mkdocs.yml

@@ -1,7 +1,5 @@
 site_name: Kubernetes Service API Evolution
 repo_url: http://sigs.k8s.io/service-apis
-site_dir: docs
-docs_dir: docs-src
 theme:
         name: material
 nav: