Compare commits

..

2 commits

Author SHA1 Message Date
2a87f4d35d
docs(readme): fix quote formatting 2024-08-11 20:51:57 -07:00
052afed2ec
docs(readme): reorganize introduction 2024-08-11 20:50:37 -07:00

View file

@ -3,21 +3,35 @@
This is a repository that implements liminalOS, my personal Linux distribution This is a repository that implements liminalOS, my personal Linux distribution
based on [NixOS](https://nixos.org/). based on [NixOS](https://nixos.org/).
<!-- prettier-ignore -->
> **lim·i·nal**
> 1. between or belonging to two different places, states, etc.
The goal of liminalOS is to allow my computing environment to exist in different
places (computers) at the same time, without the minor disparities, issues, and
inconsistencies that arise from traditional approaches such as scripting. This
works exceptionally well, demonstrated by the fact that I have the exact same
environment across three separate machines, spanning two completely different
CPU architectures.
Traditionally, we expect to configure each of our computers separately. We have Traditionally, we expect to configure each of our computers separately. We have
a general idea of the programs, settings, and minor tweaks that we like to make a general idea of the programs, settings, and minor tweaks that we like to make
on every computer, but we have to manually set all of these up. Many Unix on every computer, but we have to manually set all of these up. Many Unix
hackers have therefore created sprawling installation scripts to manage their hackers have thus created sprawling installation scripts to manage their various
various systems so they can be deployed in a predictable manner each time. Of systems so they can be deployed in a predictable manner each time. Of course,
course, scripts are still heavily dependent on environment and prone to scripts are still heavily dependent on environment and prone to breakage. When
breakage. When they inevitably break, the system is left in a malformed state, they inevitably break, the system is left in a malformed state, where some setup
where some setup actions have been taken and others have not, and it is up to actions have been taken and others have not, and it is up to the system
the system administrator to fix the failing script and ensure the system is set administrator to fix the failing script and ensure the system is set up
up properly. properly. Also, updating existing machines and rolling back to previous states
is a separate, even more difficult issue to solve with this approach.
In essence, the primary failure of setup scripts is that they are _imperative_ - In essence, the primary failure of setup scripts is that they are _imperative_ -
they must specify precisely _how_ to set up the system, down to minute details, they must specify precisely _how_ to set up the system, down to minute details,
whereas in a _declarative_ approach, the user can simply specify what the system whereas in a _declarative_ approach, the user can simply specify what the system
_should look like_, and abstractions take care of the _how_. _should look like_, and abstractions take care of the _how_. This is what NixOS
does, and it gives you remote syncing, versioning (via `git`), and rollbacks
_for free_.
NixOS provides the key tools for reliably deploying systems - namely, a _purely NixOS provides the key tools for reliably deploying systems - namely, a _purely
functional_ package manager that's reproducible by default and the necessary functional_ package manager that's reproducible by default and the necessary
@ -32,16 +46,6 @@ configuration with NixOS. Specific configuration necessary to adjust
hardware-specific details between each machines are isolated to the hardware-specific details between each machines are isolated to the
[hosts](./hosts) directory. [hosts](./hosts) directory.
> **lim·i·nal**
>
> 1. between or belonging to two different places, states, etc.
The goal of liminalOS is to allow my computing environment to exist in different
places at the same time, without the twiddling and settings syncing and minor
disparities that arise from traditional approaches. This works exceptionally
well, demonstrated by the fact that I have the exact same environment across
three separate machines, spanning two completely different CPU architectures.
## Installation guide ## Installation guide
TBD. May use `deploy-rs` or the in-house TBD. May use `deploy-rs` or the in-house