From a92770e2c62ae2c809d22a22f1c0290d67fbaff3 Mon Sep 17 00:00:00 2001 From: atagen Date: Mon, 21 Jul 2025 14:50:01 +1000 Subject: [PATCH] create readme --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..51e4fcb --- /dev/null +++ b/README.md @@ -0,0 +1,19 @@ +# a nixos config + +## mission statement + +this config attempts to follow the [synaptic standard](https://github.com/llakala/synaptic-standard/), and is built in an effort to achieve **semantic colocation**. + +ideally, our modules are categorised by the purpose they hope to fulfil, and contain all the information necessary to achieve that within their context. + +this is in contrast to many configuration styles, which may be structured in a way that is beholden to mechanical details (programs, implementations, module systems, or other scope they may carry). + +here, *we do not build our dreams of concrete*. + +## mechanism + +recursive imports and module aliasing bend the module system/s to our will. + +this allows us to create freeform sets of modules which break down broad goals into manageable units while cross-cutting module system concerns, all with a single toplevel import point. + +you can see [entry.nix](./entry.nix) and [util/create.nix](util/create.nix) for the explicit details of how this is done.