My Tech Notes for Quick Reference

https://sivaprasadreddy.github.io/sivalabs-dev-notes/

Local setup with mise

With mise installed, run from the repository root:

mise trust
mise install
mise run serve

mise manages Python 3.15 and creates and activates .venv automatically. The serve and build tasks install dependencies from requirements.txt before running MkDocs. Open http://127.0.0.1:8000/ after starting the server.

mise run install # Install dependencies only
mise run build   # Build the static site into site/
mise tasks       # List available tasks

Alternative setup with Docker

Install and start Docker (for example, Docker Desktop). From the repository root, run the Docker task with mise:

mise run docker:serve

Open http://127.0.0.1:8000/. The repository is mounted into the container so local documentation edits trigger a reload. Press Ctrl+C to stop and remove the container. Dependencies are installed inside the container each time it starts.

To build the static site with Docker, run:

mise run docker:build…