Explain how to use the container

davide125 · davide125 · commit 82db310cd534 · 2025-02-26T12:15:24.000-08:00
Signed-off-by: Davide Cavalca &lt;davide@cavalca.name&gt;
diff --git a/README.md b/README.md
@@ -4,4 +4,10 @@ This is the [Asahi Linux documentation](https://asahilinux.org/docs/) repository
 
 ## Usage
 
-This is made with [MkDocs](https://www.mkdocs.org/). Run `make build` to build the site, or `make test` to spin up a local webserver for review. The website is rebuilt by the CI on every commit and served via GitHub Pages.
+This is made with [MkDocs](https://www.mkdocs.org/). If you have mkdocs installed already, run `make build` to build the site, or `make test` to spin up a local webserver for review. If you don't, feel free to use our [container](https://github.com/AsahiLinux/docs/pkgs/container/mkdocs-asahi) with something like:
+
+```
+$ podman run -it --pull=newer -p=8000:8000 -v=$(pwd)/:/docs:z ghcr.io/asahilinux/mkdocs-asahi:latest
+```
+
+The website is rebuilt by the CI on every commit and served via GitHub Pages. The container is also automatically updated and pushed to the registry.
