# AyaNova v8 Documentation Build Environment
#
# This Dockerfile creates a reproducible build environment for the MkDocs documentation.
#
# Usage:
#   Build the image:
#     docker build -f Dockerfile.docs -t ayanova-docs-build .
#
#   Run a build (mount your docs source and output):
#     docker run --rm -v "c:/data/code/raven/docs/8.0/ayanova:/docs" -v "c:/data/code/raven/server/AyaNova/wwwroot/docs:/output" ayanova-docs-build
#
#   Serve docs locally for preview (on port 8000):
#     docker run --rm -p 8000:8000 -v "c:/data/code/raven/docs/8.0/ayanova:/docs" ayanova-docs-build mkdocs serve -a 0.0.0.0:8000
#

FROM python:3.11-slim-bullseye

# Install MkDocs and the Material theme
# pymdownx extensions come bundled with mkdocs-material
RUN pip install --no-cache-dir \
    mkdocs==1.5.* \
    mkdocs-material==9.*

WORKDIR /docs

# Default command: build the documentation
# Note: The output directory is configured in mkdocs.yml (site_dir)
# For containerized builds, you may want to override site_dir
CMD ["mkdocs", "build"]