This project came out of a need to:
- Document knowledge
- Share it in an easily readable format
- Keep it versionable
- Allow it to automatically build and ideally deploy
- Docker (For having product version control)
- Python 3.12 Alpine (to keep image size small)
- mkdocs (Pip package)
- mkdocs-material (For nicer presentation)
In order to set up the project locally, do the following:
- Install Docker on your computer.
- Clone the project repo.
docker compose up -d- Go to http://0.0.0.0:4040
- Voila. You have documentation.
The docker compose file also mounts the directory docs to the container. This allows for live editing. In the build, this is handled just by copying.
The project builds (currently) to thomasve/museit-docs:. This version is presently private to protect sensitive information.