chore: dockerise docs build (#3060)

* chore: dockerise docs build

* chore: remove from exclusion

Author: mdelapenya

.gitignore

@@ -13,8 +13,6 @@ src/pip-delete-this-directory.txt
 
 TEST-*.xml
 
-tcvenv
-
 **/go.work
 
 # VS Code settings

Makefile

@@ -23,25 +23,20 @@ tidy-all:
 
 ## --------------------------------------
 
-TCENV=tcvenv
-PYTHONBIN=./$(TCENV)/bin
-
-tcvenv: tcvenv/touchfile
-
-tcvenv/touchfile:
-	@echo "Creating docs $(TCENV)..."
-	test -d $(TCENV) || python3 -m venv $(TCENV)
-	@echo "Installing requirements..."
-	. $(PYTHONBIN)/activate; pip install -Ur requirements.txt
-	touch $(TCENV)/touchfile
+DOCS_CONTAINER=mkdocs-container
+DOCS_IMAGE=python:3.8
 
+.PHONY: clean-docs
 clean-docs:
-	@echo "Destroying docs $(TCENV)..."
-	rm -rf $(TCENV)
+	@echo "Destroying docs"
+	docker rm -f $(DOCS_CONTAINER) || true
 
 .PHONY: serve-docs
-serve-docs: tcvenv
-	. $(PYTHONBIN)/activate; $(PYTHONBIN)/mkdocs serve
+serve-docs:
+	docker run --rm --name $(DOCS_CONTAINER) -it -p 8000:8000 \
+		-v $(PWD):/testcontainers-go \
+		-w /testcontainers-go \
+		$(DOCS_IMAGE) bash -c "pip install -Ur requirements.txt && mkdocs serve -f mkdocs.yml -a 0.0.0.0:8000"
 
 ## --------------------------------------
 

docs/contributing.md

@@ -81,23 +81,21 @@ Please refer to the [codeinclude plugin documentation](https://github.com/rnorth
 
 ### Previewing rendered content
 
-#### Using Python locally
-
 From the root directory of the repository, you can use the following command to build and serve the documentation locally:
 
 ```shell
 make serve-docs
 ```
 
-It will use a Python's virtual environment to install the required dependencies and start a local server at `http://localhost:8000`.
+It will use a Docker container to install the required dependencies and start a local server at `http://localhost:8000`.
 
-Once finished, you can destroy the virtual environment with the following command:
+Once finished, you can destroy the container with the following command:
 
 ```shell
 make clean-docs
 ```
 
-#### PR Preview deployments
+### PR Preview deployments
 
 Note that documentation for pull requests will automatically be published by Netlify as 'deploy previews'.
 These deployment previews can be accessed via the `deploy/netlify` check that appears for each pull request.