Fix #13288: Convert docs to mkdocs

.gitignore

@@ -61,3 +61,4 @@ Thumbs.db
 tmp/*
 venv
 tests/unit/dist/
+site/

Dockerfile

@@ -102,7 +102,6 @@ RUN apt-install make sqlite3
 COPY docker/bin/ssllabs-scan /usr/local/bin/ssllabs-scan
 COPY requirements/* ./requirements/
 RUN pip install --require-hashes --no-cache-dir -r requirements/dev.txt
-RUN pip install --require-hashes --no-cache-dir -r requirements/docs.txt
 COPY ./setup.cfg ./
 COPY ./pyproject.toml ./
 COPY ./.coveragerc ./

Makefile

@@ -24,9 +24,8 @@ help:
 	@echo "  test                       - run tests against local files"
 	@echo "  test-image                 - run tests against files in docker image"
 	@echo "  test-cdn                   - run CDN tests against TEST_DOMAIN"
-	@echo "  docs                       - generate Sphinx HTML documentation with server and live reload using Docker"
-	@echo "  livedocs                   - generate Sphinx HTML documentation with server and live reload"
-	@echo "  build-docs                 - generate Sphinx HTML documentation using Docker"
+	@echo "  docs                       - generate mkdocs HTML documentation with server and live reload using Docker"
+	@echo "  build-docs                 - generate mkdocs HTML documentation"
 	@echo "  build-ci                   - build docker images for use in our CI pipeline"
 	@echo "  test-ci                    - run tests against files in docker image built by CI"
 	@echo "  compile-requirements       - update Python requirements files using pip-compile"
@@ -129,10 +128,10 @@ docs: .docker-build-pull
 	${DC} up docs
 
 build-docs: .docker-build-pull
-	${DC} run app make -C docs/ clean html
+	${DC} run app mkdocs build -d "docs/_build"
 
 livedocs:
-	${MAKE} -C docs/ clean livehtml
+	mkdocs serve
 
 test_infra/fixtures/tls.json:
 	${DOCKER} run -it --rm jumanjiman/ssllabs-scan:latest --quiet https://${TEST_DOMAIN}/en-US/ > "test_infra/fixtures/tls.json"

bin/compile-requirements.sh

@@ -17,4 +17,3 @@ pip install pip-tools==6.13.0
 
 pip-compile --generate-hashes -r requirements/prod.in --resolver=backtracking --rebuild
 pip-compile --generate-hashes -r requirements/dev.in --resolver=backtracking --rebuild
-pip-compile --generate-hashes -r requirements/docs.in --resolver=backtracking --rebuild

docker-compose.yml

@@ -105,7 +105,7 @@ services:
   docs:
     image: mozmeao/bedrock_test:${GIT_COMMIT:-latest}
     platform: linux/amd64
-    command: sphinx-autobuild "docs" "docs/_build/html" --host 0.0.0.0 --port 8100
+    command: mkdocs serve -d "docs/_build" -a "0.0.0.0:8100"
     ports:
       - "8100:8100"
     volumes: