mirror of
https://github.com/foo-dogsquared/nixos-config.git
synced 2025-02-24 18:19:01 +00:00
docs/site: write "Introduction" chapter
This commit is contained in:
parent
4d24fa51c3
commit
471202f73f
45
docs/content/en-US/introduction/index.adoc
Normal file
45
docs/content/en-US/introduction/index.adoc
Normal file
@ -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.
|
||||
====
|
@ -1,4 +1,4 @@
|
||||
* link:./introduction[Introduction]
|
||||
* link:{{< relref "./introduction/" >}}[Introduction]
|
||||
|
||||
* The lay of the land
|
||||
** link:./lay-of-the-land/prerequisites/[Prerequisites]
|
||||
|
Loading…
Reference in New Issue
Block a user