foodogsquared/nixos-config
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/nixos-config.git synced 2025-02-07 12:19:07 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

docs/site: improve site and book introduction

Browse Source
This commit is contained in:
Gabriel Arazas 2023-07-09 18:28:16 +08:00
parent 10a047358e
commit bb0bf1a2b2
No known key found for this signature in database
GPG Key ID: ADE0C41DAB221FCC
2 changed files with 29 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/content/en-US/_index.adoc
View File

@ -8,24 +8,31 @@ image::./nix-snowflake.svg[width=256px]
Why don't you start skimming the "book" by taking a glance at the table of contents over there.
[chat, Ezran, role=reversed]
[chat, Ezran, state=curious, role=reversed]
====
And what if your readers doesn't find it?
Why would you have an entire book on just your NixOS configuration?
This seems like overkill.
====
[chat, foodogsquared]
[chat, foodogsquared, state=cheeky]
====
I suppose you can view an entire page of it at link:./menu[`./menu`].
Because **it is overkill** and that's what we're going for.
====
[chat, Ezran, state=disappointed, role=reversed]
====
You didn't bother to improve the way how the menu rendered though unlike in mdBook or something similar.
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 not use something like github:rust-lang/mdBook[mdBook]?
Or link:https://squidfunk.github.io/mkdocs-material/[mkdocs-material] that makes things eas-
====
[chat, foodogsquared]
[chat, Ezran, state=skeptical, role=reversed]
====
Yeah, so?
It just happen to double as a neat standalone way to view the table of contents.
It's a feature, not a bug.
You know what, I'm not going to continue with this.
I think I know why.
====

33
docs/content/en-US/introduction/index.adoc
View File

@ -14,31 +14,24 @@ 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]
Take note this configuration serves as a platform for experimenting with the Nix ecosystem.
It is a personal configuration after all so all changes can happen on a whim including adding a component into the Nix systems, removing a flake input, __et cetera__ and __et cetera__.
This documentation serves as an overview for what I'm looking into the Nix ecosystem and hopefully can help some poor soul treading through the documentation (or lack thereof) present in the ecosystem.
Otherwise, it's just a project just to be a showoff that I have a dedicated website for my configuration, MUAHAHAHAHAHAH!
[chat, Ezran, role=reversed]
====
Why would you have an entire book on just your NixOS configuration?
This seems like overkill.
I feel this project exists for the latter point in that last paragraph.
====
[chat, foodogsquared, state=cheeky]
[chat, foodogsquared]
====
Because **it is overkill** and that's what we're going for.
Yeah, so?
====
[chat, Ezran, state=disappointed, role=reversed]
[chat, Ezran, 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 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, state=skeptical, role=reversed]
====
You know what, I'm not going to continue with this.
I think I know why.
You do you.
Your project, your rules.
====