Add build instructions

Signed-off-by: Davide Cavalca <[email protected]>

Author: davide125

.gitignore

@@ -0,0 +1 @@
+site/

Makefile

@@ -0,0 +1,13 @@
+help:
+	@echo "Run 'make test' to test locally or 'make build' to render the static site"
+
+build:
+	mkdocs build
+
+clean:
+	rm -rf site
+
+test:
+	mkdocs serve
+
+.PHONY: help build test

README.md

@@ -1,4 +1,7 @@
-## Asahi Linux documentation repository
+# Asahi Linux documentation repository
 
-This repo used to be a dummy placeholder to host the [documentation wiki](https://github.com/asahilinux/docs/wiki). It is now being converted into mkdocs.
+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.