Use mdbook (from the Rust project) for documentation

.gitignore

@@ -1,3 +1,4 @@
+book/
 build/
 terraform-*-tmp-*/
 

docs/Makefile

@@ -1,5 +1,7 @@
 .POSIX:
 
+default: book
+
 .PHONY: todo
 todo:
 	printf "# TODO\n\n" > todo.md
@@ -12,3 +14,7 @@ todo:
 diagrams:
 	cd diagrams \
 		&& python *
+
+.PHONY: book
+book: todo
+	mdbook build .

docs/SUMMARY.md

@@ -0,0 +1,9 @@
+# Summary
+
+[Introduction](./introduction.md)
+
+---
+
+[Changelog](./changelog.md)
+[Roadmap](./roadmap.md)
+[Todo](./todo.md)

docs/book.toml

@@ -0,0 +1,10 @@
+[book]
+authors = ["Khue Doan"]
+language = "en"
+multilingual = false
+src = "."
+title = "Khue's Homelab"
+
+[output.html]
+git-repository-url = "https://github.com/khuedoan/homelab"
+edit-url-template = "https://github.com/khuedoan/homelab/edit/master/docs/{path}"

docs/introduction.md

@@ -0,0 +1 @@
+# Introduction

tools/Dockerfile

@@ -13,6 +13,7 @@ RUN yes | pacman --sync --refresh \
         kubectl \
         libisoburn \
         make \
+        mdbook \
         p7zip \
         python \
         python-netaddr \