From 471202f73fb59f690b88a12c1c475fa26d22acdd Mon Sep 17 00:00:00 2001
From: Gabriel Arazas <foodogsquared@foodogsquared.one>
Date: Sat, 8 Jul 2023 20:24:05 +0800
Subject: [PATCH] docs/site: write "Introduction" chapter

---
 docs/content/en-US/introduction/index.adoc | 45 ++++++++++++++++++++++
 docs/content/en-US/menu.adoc               |  2 +-
 2 files changed, 46 insertions(+), 1 deletion(-)
 create mode 100644 docs/content/en-US/introduction/index.adoc

diff --git a/docs/content/en-US/introduction/index.adoc b/docs/content/en-US/introduction/index.adoc
new file mode 100644
index 00000000..6bf2118d
--- /dev/null
+++ b/docs/content/en-US/introduction/index.adoc
@@ -0,0 +1,45 @@
+---
+title: Introduction
+---
+= Introduction
+
+Hey there, fellow traveler!
+You've fell into the rabbit hole we call Nix where it leads to other rabbit holes such as functional package management, reproducibility, declarative systems, and immutable operating systems.
+
+Legends say the rabbit hole runs so deep you'll eventually spend hours to create a dedicated website only for your NixOS configuration.
+However, I haven't seen this for myself nor I see much examples of it.
+But it is just mere legend anyways for a radically different package management, operating system, and deployment method, so who cares really.
+
+Anyways...
+What you're seeing right now is the documentation for my NixOS configuration as a link:https://www.tweag.io/blog/2020-05-25-flakes/[Nix flake].
+It eventually evolves as a massive blob of abomination that will surely get simpler as time go by.
+
+[chat, Ezran, state=curious, role=reversed]
+====
+Why would you have an entire book on just your NixOS configuration?
+This seems like overkill.
+====
+
+[chat, foodogsquared]
+====
+Because **it is overkill** and that's what we're going for.
+====
+
+[chat, Ezran, state=curious, role=reversed]
+====
+And what is this book made of?
+Hugo?
+With Asciidoctor?
+With a customized version of github:foo-dogsquared/hugo-theme-more-contentful[your own theme]?
+Of all options!?!
+Why?
+
+Why not use something like github:rust-lang/mdBook[mdBook]?
+Or link:https://squidfunk.github.io/mkdocs-material/[mkdocs-material] that makes things eas-
+====
+
+[chat, Ezran, role=reversed]
+====
+You know what, I'm not going to continue with this.
+I think I know why.
+====
diff --git a/docs/content/en-US/menu.adoc b/docs/content/en-US/menu.adoc
index 543dca79..d5c6b9f9 100644
--- a/docs/content/en-US/menu.adoc
+++ b/docs/content/en-US/menu.adoc
@@ -1,4 +1,4 @@
-* link:./introduction[Introduction]
+* link:{{< relref "./introduction/" >}}[Introduction]
 
 * The lay of the land
 ** link:./lay-of-the-land/prerequisites/[Prerequisites]