Add Docker Support to Improve Contributor Onboarding and Development Workflow #303
Description
Description:
Currently, contributors need to install all project dependencies locally in order to build and preview the documentation site. This can slow down onboarding, especially when rebuilding the entire project is required just to preview small changes such as CSS updates.
I would like to propose adding a Docker-based development environment to the project.
Why This Would Help
- No local dependency installation: Contributors wouldn’t need Node.js or third-party packages installed on their machines.
- Consistent environment: Docker ensures everyone runs the same versions of tools and packages.
- Faster development loop: A Docker setup can watch for file changes and rebuild incrementally, reducing the need to rebuild the entire site repeatedly.
- Future-proofing: If the project eventually migrates to a modern SPA framework (e.g., React, Next.js), having Docker already integrated would make that transition easier and keep the workflow consistent.
Proposed Solution
Add a lightweight Dockerfile for local development.
Use Docker Compose (optional) to streamline the workflow.
Enable hot-reload/watch mode inside the container for immediate feedback when editing documentation or styling.