diff --git a/content/about.md b/content/about.md index a808c925..8515b76a 100644 --- a/content/about.md +++ b/content/about.md @@ -11,11 +11,11 @@ packages that can be used for anything from **putting configuration files into p **declaratively managing an entire system**. That means that, with a few well-written Nix expressions, one -can easily configure a system into a known state -- and the packages that are created this +can easily configure a system into a known state --- and the packages that are created this way are guaranteed to run _exactly the same way_ on any system of the same architecture. As a fork of CppNix, Lix is designed to be fully compatible with the original CppNix -implementation -- but also designed to allow evolution of the language and tooling, so +implementation --- but also designed to allow evolution of the language and tooling, so its developers can improve usability and ergonomics without sacrificing correctness. ### Why use Nix? @@ -31,21 +31,21 @@ to clusters of critical infrastructure. With this in mind, the Lix team has been provide a collection of necessary improvements over CppNix: - **Built for a community, not for a corporation.** - Lix is built by a team of open-source volunteers -- and exists to provide a alternative to the + Lix is built by a team of open-source volunteers --- and exists to provide a alternative to the commercial interests that have long plagued both upstream CppNix and corporate-authored forks. We're proud to stand by our open [conflict of interest statements](/team#conflict-of-interest-statements), and proud to listen to community voices on issues of sponsorship, direction, and moderation. - **A safe community for developers of all backgrounds.** - Lix is developed by a diverse group of users -- and accordingly is committed to providing a + Lix is developed by a diverse group of users --- and accordingly is committed to providing a space that's safe for users and developers typically underrepresented in technical projects. We take moderation seriously, and are committed to preventing bad actors from driving out marginalized groups. - **A correct implementation of the Nix language.** - Recent versions of the CppNix project have introduced significant regressions -- so much so + Recent versions of the CppNix project have introduced significant regressions --- so much so that the upstream [Nixpkgs](https://github.com/nixos/nixpkgs) team has opted to remain several - versions behind. Lix is forked from the last truly-stable version of CppNix -- but has both + versions behind. Lix is forked from the last truly-stable version of CppNix --- but has both introduced new features and backported a number of features from newer versions without sacrificing correctness. @@ -53,12 +53,12 @@ provide a collection of necessary improvements over CppNix: Lix is designed for evolution of its codebase. Lix already uses the more modern [meson build system](https://mesonbuild.com/), which improves developer usability and decreases build times. Plans include a gradual, piecewise introduction of the memory-safe [Rust](https://www.rust-lang.org/) - programming language -- to both supplement and replace sections of the current C++ codebase. + programming language --- to both supplement and replace sections of the current C++ codebase. - **A language with room to grow.** - Unlike upstream Nix, Lix intends to be an evolving language -- a robust language versioning + Unlike upstream Nix, Lix intends to be an evolving language --- a robust language versioning system will allow the language to grow and evolve without sacrificing backwards-compatibility or correctness. - And room to grow means room for **usability and ergonomics improvements** -- both in the langauge and in + And room to grow means room for **usability and ergonomics improvements** --- both in the langauge and in tooling. diff --git a/content/add-to-config.md b/content/add-to-config.md index 97ace920..bcdb4684 100644 --- a/content/add-to-config.md +++ b/content/add-to-config.md @@ -176,7 +176,7 @@ great time to check out some of the [community's resources on Nix](/resources). ## Having Trouble? **One quick thing to check:** have you set `nix.package` anywhere in your configuration? -If so, your configuration option will override the Lix module. You'll want to remove it, first -- +If so, your configuration option will override the Lix module. You'll want to remove it, first --- or, if you're feeling savvy, point it to the provided Lix package. **Otherwise:** If you're having difficulty installing Lix, don't panic! Hop on over to our diff --git a/content/community.md b/content/community.md index 7f657773..afec32c0 100644 --- a/content/community.md +++ b/content/community.md @@ -1,12 +1,12 @@ ---- +---- title: "Lix Community" description: "it's not an ice cream party, but it might as well be" date: "2024-04-27" author: "Lix Team" ---- +---- -Lix exists **first and foremost for its community** -- and we very much hope that will include you! -If you're looking for help, have any questions, want to pitch in -- or just want to talk -- join us +Lix exists **first and foremost for its community** --- and we very much hope that will include you! +If you're looking for help, have any questions, want to pitch in --- or just want to talk --- join us using [one of the venues below](#engaging-with-the-community) . ## Community Standards @@ -24,22 +24,22 @@ nor a small foundation board that governs the community. Instead, **we rely on t and users to carry the burdens of maintenance and governance**. We're currently in the process of establishing a more full-fledged governance model, which we believe must -be built on engagement with -- and feedback from -- our community. In the interim, decisions are made by +be built on engagement with --- and feedback from --- our community. In the interim, decisions are made by simple voting, with one vote held by each member of the "[core team](/team)", who are acting as interim governance. ## Engaging with the Community -The best way to engage with the community currently is to **join our Matrix space** -- a decentralized +The best way to engage with the community currently is to **join our Matrix space** --- a decentralized chat platform commonly used among open-source projects. ### Lix Matrix -Joining is relatively straightforward -- you can find us on the `lix.systems` Matrix server. +Joining is relatively straightforward --- you can find us on the `lix.systems` Matrix server. The easiest way to connect with us is to join our [Matrix space](https://matrix.to/#/#space:lix.systems), which will allow you to see previews of and join the most relevant community rooms. -Note that all community venues -- including our Matrix rooms -- are subject to our [community standards](/community-standards). +Note that all community venues --- including our Matrix rooms --- are subject to our [community standards](/community-standards). ### Community Resources diff --git a/content/faq.md b/content/faq.md index 86f6a879..8d1b7ede 100644 --- a/content/faq.md +++ b/content/faq.md @@ -5,7 +5,7 @@ date: "2024-05-01" author: "Lix Team" --- -These are the most common questions we get -- or anticipate getting. If you can't find the answer +These are the most common questions we get --- or anticipate getting. If you can't find the answer you're looking for, please feel free to ask over in the [community](/community).
@@ -20,31 +20,31 @@ Check out the [install page](/install) to see how to use Lix with your existing #### Q: What are your plans for flakes? One of our primary goals is compatibility. While flakes are an experimental technology, their use is -widespread enough that they've become a de-facto part of the Nix ecosystem -- and thus we consider them +widespread enough that they've become a de-facto part of the Nix ecosystem --- and thus we consider them to be part of our compatibility guarantee. That said, we're not tied to any particular flake implementation. As Lix develops, we plan on adding an -extension system for the tooling -- which will allow technologies like flakes, as well as new and different -extensions -- to seamlessly act with the Lix core without needing to reside long-term in the Lix tree. +extension system for the tooling --- which will allow technologies like flakes, as well as new and different +extensions --- to seamlessly act with the Lix core without needing to reside long-term in the Lix tree. _Flakes are not the only way to write Nix language code in Lix, and we intend to provide a good experience -to those using flakes -- while also improving the experience for those not using them -- +to those using flakes --- while also improving the experience for those not using them --- by evolving a compatible but more flexible flake-like abstraction in the periphery of the Lix system._ #### Q: What relation does Lix have to the Nix Foundation, and to related projects? Besides being a fork of CppNix and an implementation of the Nix language, Lix is the -effort of a number of long-time Nix, Nixpkgs, NixOS, and Tvix contributors and maintainers -- and has +effort of a number of long-time Nix, Nixpkgs, NixOS, and Tvix contributors and maintainers --- and has been developed in partnership with a number of prolific Nix-documenters, bloggers, and users. -We welcome anyone who wants to develop for both Lix and another implementation -- including CppNix and Tvix, +We welcome anyone who wants to develop for both Lix and another implementation --- including CppNix and Tvix, and our open-source implementation absolutely allows any developer to integrate our code into any license-compatible project. However, ___Lix does not fall under the NixOS Foundation umbrella___, is funded independently of the foundation, and is not in any way controlled by its leadership. With the recent reboot of the foundation's governance, -we are in communication with -- and open to collaboration with -- the foundation. +we are in communication with --- and open to collaboration with --- the foundation. #### Q: How does Lix work? How can I contribute or help out? @@ -88,11 +88,11 @@ will gladly make you one manually. #### Q: If Lix plans to adopt Rust, what makes it different from Tvix? Unlike Lix, [Tvix](https://tvix.dev/) is a ground-up re-implementation of the Nix language in Rust, -which shares many of the same modernization goals as Lix -- but also has a long way to go before it can +which shares many of the same modernization goals as Lix --- but also has a long way to go before it can reach feature parity (and parity in correctness) with the CppNix and Lix implementations. -Lix instead plans a _top-down_, _piecewise_ approach to our Rust extensions and replacements -- which means -that Lix already has feature-parity with -- and correctness exceeding -- the original CppNix. +Lix instead plans a _top-down_, _piecewise_ approach to our Rust extensions and replacements --- which means +that Lix already has feature-parity with --- and correctness exceeding --- the original CppNix. #### Q: What does the name Lix stand for? How is it pronounced? @@ -100,5 +100,5 @@ that Lix already has feature-parity with -- and correctness exceeding -- the ori Like Nix, Lix isn't really short for anything. The name originally derives from the term _Layered Nix_, based on the premise of layering new language and tooling features atop a fully-compatible, rock-solid base. -Lix is pronounced like _licks_ -- i.e. what you might do if someone handed you a delicious ice cream cone; +Lix is pronounced like _licks_ --- i.e. what you might do if someone handed you a delicious ice cream cone; which may or may not be stacked up with lambdas. diff --git a/content/install.md b/content/install.md index aa7f1c3e..c735c572 100644 --- a/content/install.md +++ b/content/install.md @@ -1,15 +1,15 @@ ---- +---- title: "Installing Lix" description: "or: how to make your configuration Delicious" date: "2024-04-27" author: "Lix Team" ---- +---- Whether you're a new or returning user, **we're thrilled you've decided to pick up Lix!** Lix works out-of-the-box on most Linux and MacOS systems, including with system management tools such as [home-manager](https://github.com/nix-community/home-manager) and -[nix-darwin](https://github.com/LnL7/nix-darwin) -- but, like any Nix-based system, some Nix background +[nix-darwin](https://github.com/LnL7/nix-darwin) --- but, like any Nix-based system, some Nix background knowledge is recommended before installation. If you're new to the Nix ecosystem, you may want to check out some [community resources](/resources) @@ -55,7 +55,7 @@ Open a terminal, and run the following command: curl -sSf -L https://install.lix.systems/lix | sh -s -- install ``` -The installer will guide you through installing Lix -- and once it's finished, +The installer will guide you through installing Lix --- and once it's finished, you'll have a full, working installation. If you're not sure what to do, now is a great time to check out some of the [community's resources on Nix](/resources). diff --git a/content/resources.md b/content/resources.md index a9c1d5d0..f0aeebc8 100644 --- a/content/resources.md +++ b/content/resources.md @@ -5,7 +5,7 @@ date: "2024-04-27" author: "Lix Team" --- -Lix doesn't exist in a vacuum -- but instead builds atop the incredible work of dozens of +Lix doesn't exist in a vacuum --- but instead builds atop the incredible work of dozens of NixOS community members. This page collects resources that have been recommended by members of the community. diff --git a/content/team.md b/content/team.md index f3836823..44dc1a13 100644 --- a/content/team.md +++ b/content/team.md @@ -13,7 +13,7 @@ and users to carry the burdens of maintenance and governance. The **core team** are the developers most directly responsible for the Lix project. While the project is in its "soft-release" period, these folks are responsible for project governance. One of their main -tasks is to establish a lasting governance model -- and other teams to handle things! +tasks is to establish a lasting governance model --- and other teams to handle things! Members (in alphabetical order): @@ -44,7 +44,7 @@ Members (in alphabetical order): - **puck ([@puckipedia](https://github.com/puckipedia), she/her [singular] or they/them [plural])** - **Qyriad ([@Qyriad](https://github.com/Qyriad), she/her [singular] or they/them [plural])** - Build system experts who delve way, way too deep into tooling -- so you don't have to. + Build system experts who delve way, way too deep into tooling --- so you don't have to. - **raito ([@RaitoBezarius](https://github.com/RaitoBezarius), he/him)** Raito is working on nixpkgs packaging, infrastructure, and review in Lix. @@ -55,12 +55,12 @@ Members (in alphabetical order):
We all hang around in [community spaces](/community), including on Matrix. Feel free to pop into -the Lix channels and say hello -- we'd love to hear what you think of Lix! +the Lix channels and say hello --- we'd love to hear what you think of Lix! ## Conflict of Interest Statements As a community project, it's important that project decisions are made **exclusively for the -benefit of the community**, and don't serve any other interests -- including personal or corporate gain. +benefit of the community**, and don't serve any other interests --- including personal or corporate gain. If a team member is unable to do so in any context, they are **required** to disclose the _conflict of interest_ and to recuse themselves from any leadership decisions affected.