Advanced Search
Search Results
85 total results found
Lix contributors
This is the main information hub for drive-by contributors and regular developers alike. Everyone is encouraged to partake in documenting our project in here. Feeling insecure about an edit? Ask for affirmation in our Matrix channel :)
Lix
All about Lix
Running Lix main
Thank you for choosing to help us dogfood in our daily development! If you run into any issues, you can reach out for quick support in #running-main:lix.systems on Matrix. There is a lot of work-in-progress documentation and a lot of it is work in progress or ...
Style Guide
Not just about code, a style guide is a list of decisions we've made, that we want to be consistent about going forwards. It does not need to be comprehensive of all possible issues, nor does it need to confine itself to trivial topics such as formatting. It's...
Information organisation
Lix has a lot of information as a project, and we want to make it accessible in a way that it can be found later if necessary. There are various tools for keeping information in the project, and they have different purposes Chat Chat is good for: Information ...
Lix infrastructure guide
Information about adminstering Lix's infrastructure.
Working in the Lix codebase
See also: See also: https://git.lix.systems/lix-project/lix/src/branch/main/doc/manual/src/contributing/hacking.md
Code
Code changes Tests If at all practicable, all new code should be tested to some extent. If writing a test is hard, we need to prioritize making it easier, and potentially block features if that is the case. Documentation Reference documentation should be added...
Lix organisation
Information related to the Lix project organisation.
Design planning
This is the place where we plan major changes to various components of the code base, to tackle the big issues. Treat everything as an unimplemented idea unless stated otherwise. Make sure to link to implementation efforts in order to keep track of them. Idea...
Language and terminology
Language Most existing Lix documentation is written in British English. We intend to continue with that. Terminology (FIXME: unsure if this should be in the style guide but ... it kinda should be -jade) Nix language - Use this to refer to the language which ...
Auth/SSO systems
A major part of Lix infrastructure is the authentication/SSO systems. Here, you can find information about how to run them.
Misc tips
pyright is not dealing with import paths correctly for functional2 I don't know why it's doing this but it seems to be assuming that the functional2 test suite is relative to the workspace root. You can jam the following into :CocLocalConfig for vim, and proba...
Tooling improvements
We use a lot of tooling. There are papercuts we run into with our use cases that we would really like to have fixed.
Bug tracker organisation
We have a repo of directly imported nix bugs at https://git.lix.systems/nixos/nix. Please don't file bugs in there, we want the IDs to match. When we import a bug, we might put notes on there as we triage it, and potentially close it. Bug labels on NixOS/nix ...
Gerrit
FIXME: this page is duplicating a lot of content from the Gerrit section and should be considered deprecated See the Gerrit section in this book for newer pages. TODO: "Workflow tips" section seems to have got mangled in that transition and needs migration. Wh...
Postmortems
Improving build times
Setup Use a clang stdenv: nix develop .#native-clangStdenvPackages Then delete build/ if you were using gcc before. Enable build-time profiling with: just setup; meson configure build -Dprofile-build=enabled Then run the build: just compile. Enabling build-tim...
Lix users
Various information for lix users beyond the main documentation, as well as instructions how to use Lix from the `main` branch
Freezes and recommended contributions
Suggested contributions Consider taking an issue marked E-help wanted: assign it to yourself and have a go. Feel free to ask for help in the development channel. The Lix team wants these issues fixed, but they are not high on our agenda to fix ourselves. When ...