Update guidance and tooling for documentation

CONTRIBUTING.md

@@ -43,6 +43,7 @@ Follow our [Installation Instructions](https://docs.nginx.com/nginx-gateway-fabr
 - We use [Go Modules](https://github.com/golang/go/wiki/Modules) for managing dependencies.
 - We use [Ginkgo](https://onsi.github.io/ginkgo/) and [Gomega](https://onsi.github.io/gomega/) for our BDD style unit
   tests.
+- The documentation website is found under `site/`.
 
 ## Contributing
 
@@ -93,6 +94,7 @@ Before beginning development, familiarize yourself with the following documents:
   conventions to follow when writing Go code for the project.
 - [Architecture](https://docs.nginx.com/nginx-gateway-fabric/overview/gateway-architecture/): A high-level overview of the project's architecture.
 - [Design Principles](/docs/developer/design-principles.md): An overview of the project's design principles.
+- [NGINX Gateway Fabric Documentation](/site/README.md): An explanation of the documentation tooling and conventions.
 
 ## Contributor License Agreement
 

site/Makefile

@@ -12,7 +12,7 @@ ifeq (, $(shell ${HUGO} version 2> /dev/null))
 ifeq (, $(shell docker version 2> /dev/null))
     $(error Docker and Hugo are not installed. Hugo (<0.91) or Docker are required to build the local preview.)
 else
-    HUGO=docker run --rm -it -v ${CURDIR}:/src -p 1313:1313 ${HUGO_IMG} hugo --bind 0.0.0.0 -p 1313
+    HUGO=docker run --rm -it -v ${CURDIR}:/src -p 1313:1313 ${HUGO_IMG} hugo
 endif
 endif
 
@@ -43,7 +43,6 @@ else
 endif
 endif
 
-
 .PHONY: all all-staging all-dev all-local clean hugo-mod build-production build-staging build-dev docs-drafts docs deploy-preview
 
 all: hugo-mod build-production
@@ -54,28 +53,25 @@ all-dev: hugo-mod build-dev
 
 all-local: clean hugo-mod build-production
 
-# Removes the public directory generated by the `hugo` command
+docs:
+	${HUGO}
+
 clean:
 	if [[ -d ${PWD}/public ]] ; then rm -rf ${PWD}/public && echo "Removed public directory" ; else echo "Did not find a public directory to remove" ; fi
 
+watch:
+	${HUGO} --bind 0.0.0.0 -p 1313 server --disableFastRender
 
-docs-drafts:
-	${HUGO} server -D --disableFastRender
-
-docs-local: clean
-	${HUGO}
-
-docs:
-	${HUGO} server --disableFastRender
-
-lint-markdown:
-	${MARKDOWNLINT} -c .markdownlint.yaml  -- content
+watch-drafts:
+	${HUGO} --bind 0.0.0.0 -p 1313 server -D --disableFastRender
 
 link-check:
 	${MARKDOWNLINKCHECK} $(shell find content -name '*.md')
 
+lint-markdown:
+	${MARKDOWNLINT} -c .markdownlint.yaml  -- content
 
-## commands for use in Netlify CI
+# Commands used by Netlify CI
 hugo-mod:
 	hugo mod get $(THEME_MODULE)@v$(THEME_VERSION)