aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristopher R. Nelson <christopher.nelson@languidnights.com>2026-01-19 09:25:13 -0500
committerChristopher R. Nelson <christopher.nelson@languidnights.com>2026-01-19 09:25:13 -0500
commit64c9258270614f44d65999e674b2d54e402b2fa8 (patch)
tree818efc223c3dfd24afaa3132d6cc97e05a83510c
parent54f433e88e8e3333eef54f7161f35114e25374b1 (diff)
Finish README
-rw-r--r--README.rst24
1 files changed, 22 insertions, 2 deletions
diff --git a/README.rst b/README.rst
index 1a6d9e9..8a62d98 100644
--- a/README.rst
+++ b/README.rst
@@ -1,9 +1,29 @@
Purpose
=======
-This repo is my *personal* dotfile repositories. While there are some ideas I consider interesting, I don't promise or even suggest that this'll be applicable directly to you.
+This repo is my *personal* dotfile repositories. While there are some ideas
+I consider interesting, I don't promise or even suggest that this'll be
+applicable directly to you.
Main Idea
=========
-I use `GNU Guix` for a few systems in my home network.
+I use `GNU Guix`_ for a few systems in my home network. Following the manual_
+is useful, but doesn't really describe composability and inheritance and all
+the other fun stuff you get from using a `programming language`_ to do your
+config. I've made a stab at one approach that lets me set up new stuff quickly,
+and a couple example/reference configs that use this approach. Give
+a host-name, user info, and spin up a config right quick.
+
+Caveat Emptor
+=============
+
+Always be careful of whose stuff you trust, especially when *they* warn you.
+I use and pull in some non-free software (notable firmware and GPU drivers).
+This is not the GNU way, but a practical decision I've made. Make sure, if you
+do drop-in this, that you trust both me and all the sources in channels.scm
+*and* the non-free code they pull.
+
+_GNU Guix: https://guix.gnu.org
+_manual: https://guix.gnu.org/manual/devel/en/html_node/index.html
+_programming language: https://www.gnu.org/software/guile/manual/