feat: Allow mkdocs to livereload when using docker (argoproj#17383)

* feat: Allow mkdocs to livereload when using docker

Signed-off-by: Carlos Santana <csantana23@gmail.com>

* update the docs

Signed-off-by: Carlos Santana <csantana23@gmail.com>

---------

Signed-off-by: Carlos Santana <csantana23@gmail.com>
Signed-off-by: Mangaal <angommeeteimangaal@gmail.com>

Makefile

@@ -528,8 +528,7 @@ serve-docs-local:
 
 .PHONY: serve-docs
 serve-docs:
-	docker run ${MKDOCS_RUN_ARGS} --rm -it -p 8000:8000 -v ${CURRENT_DIR}/site:/site -w /site --entrypoint "" ${MKDOCS_DOCKER_IMAGE} python3 -m http.server --bind 0.0.0.0 8000
-
+	docker run ${MKDOCS_RUN_ARGS} --rm -it -p 8000:8000 -v ${CURRENT_DIR}:/docs -w /docs --entrypoint "" ${MKDOCS_DOCKER_IMAGE} sh -c 'pip install -r docs/requirements.txt; mkdocs serve -a $$(ip route get 1 | awk '\''{print $$7}'\''):8000'
 
 # Verify that kubectl can connect to your K8s cluster from Docker
 .PHONY: verify-kube-connect

docs/developer-guide/site.md

@@ -2,15 +2,20 @@
 
 ## Developing And Testing
 
-The website is built using `mkdocs` and `mkdocs-material`. 
+The website is built using `mkdocs` and `mkdocs-material`.
 
 To test:
 
 ```bash
-make build-docs
 make serve-docs
 ```
-Once running, you can view your locally built documentation at [http://0.0.0.0:8000/](http://0.0.0.0:8000/). 
+Once running, you can view your locally built documentation at [http://0.0.0.0:8000/](http://0.0.0.0:8000/).
+Make a change to documentation and the website will rebuild and refresh the view.
+
+Before submitting a PR build the website, to verify that there are no erros building the site
+```bash
+make build-docs
+```
 
 ## Analytics