content: add community page
This commit is contained in:
Kate Temkin
parent
c5a11acd61
commit
5aa27eb08a
6 changed files with 198 additions and 82 deletions
27
TODO.md
27
TODO.md
|
|
@ -1,33 +1,42 @@
|
|||
TODO List
|
||||
==========
|
||||
|
||||
## Misc
|
||||
## Soft Release
|
||||
|
||||
### Misc
|
||||
|
||||
- Move "The Team" to under community
|
||||
- Fix the favicon
|
||||
- Remove the "pending pull request" from the install page, once that's merged.
|
||||
- Add social media icons below lix for mastodon/github/etc.
|
||||
- Figure out where "usability" should link to.
|
||||
|
||||
## Pages
|
||||
### Pages
|
||||
|
||||
- Create the `/resources` page, with resources for learning Nix.
|
||||
- Create a /community page linking to matrix.
|
||||
- Create a /community-standards page (raito is creating text)
|
||||
- Link "/contributing" to... maybe the wiki?
|
||||
- Figure out where to link the "Docs" link to, and uncomment it.
|
||||
|
||||
## Graphics
|
||||
### Graphics
|
||||
|
||||
- Fix the fact that Hugo is sticking the wrong thing into the alt texts.
|
||||
- Replace the primary "hero" graphic with a Lix one.
|
||||
- Replace the "lix-managed systems" graphic with an image of our logo on a screen.
|
||||
- Replace the placeholders for each of the three main page "why lix" points.
|
||||
- Add nice images to the "/about" page.
|
||||
|
||||
# Wishlist
|
||||
## Wishlist
|
||||
|
||||
### Misc
|
||||
|
||||
- Fix the way CSS makes the page look on narrower monitors
|
||||
- Fix the CSS vertical alignment on webkit mobile
|
||||
- Figure out where to link the "Docs" link to, and uncomment it.
|
||||
|
||||
### Content
|
||||
|
||||
- Screenshots (incl. maybe of Xil) showing ergonomics enhancements in the /about page.
|
||||
- Create /roadmap.
|
||||
- Create /infrastructure.
|
||||
|
||||
### Graphics
|
||||
|
||||
- Add nice images to the "/about" page.
|
||||
- Replace the primary "hero" graphic with a Lix one.
|
||||
|
|
|
|||
|
|
@ -40,9 +40,9 @@ menus:
|
|||
url: "/about"
|
||||
weight: 2
|
||||
|
||||
- name: "The Team"
|
||||
url: "/team"
|
||||
weight: 3
|
||||
- name: "FAQs"
|
||||
url: "/faq"
|
||||
weight: 2
|
||||
|
||||
#- name: "Docs"
|
||||
# url: "/#"
|
||||
|
|
@ -65,7 +65,7 @@ menus:
|
|||
weight: 8
|
||||
|
||||
buttons:
|
||||
- name: "Install Lix"
|
||||
- name: "Install Lix (beta)"
|
||||
url: "/install"
|
||||
weight: 5
|
||||
pre: "btn btn-primary text-light"
|
||||
|
|
|
|||
|
|
@ -61,63 +61,3 @@ provide a collection of necessary improvements over CppNix:
|
|||
And room to grow means room for [usability and ergonomics improvements](#) -- both in the langauge and in
|
||||
tooling.
|
||||
|
||||
## Frequently Asked Questions (relatively speaking)
|
||||
|
||||
#### Q: Can I use my existing Nix/NixOS configuration?
|
||||
|
||||
Absolutely. A primary goal of the Lix project is compatibility, which means that we very much support
|
||||
using Lix in any existing Nix or NixOS configuration.
|
||||
|
||||
Check out the [install page](/install) to see how to use Lix with your existing configurations.
|
||||
|
||||
#### 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
|
||||
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.
|
||||
|
||||
|
||||
#### 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
|
||||
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_,
|
||||
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. Unfortunately, at the moment, this is vital for
|
||||
us to deliver on our promise of a safe and inclusive community.
|
||||
|
||||
|
||||
#### 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
|
||||
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.
|
||||
|
||||
|
||||
#### Q: What does the name Lix stand for? How is it pronounced?
|
||||
|
||||
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;
|
||||
which may or may not be stacked up with lambdas.
|
||||
|
||||
|
||||
#### Q: Can I help?
|
||||
|
||||
Absolutely! We love new contributors, and are always looking for contributions in all of our areas -- and
|
||||
we value contributions of more than just code.
|
||||
|
||||
Head over to the [contributing](/contributing) page to get started.
|
||||
|
|
|
|||
|
|
@ -5,3 +5,44 @@ 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
|
||||
using [one of the venues below](Engaging-with-the-Community) .
|
||||
|
||||
## Community Standards
|
||||
|
||||
As part of our responsibility to community, we are dedicated to creating a safe and welcoming environment
|
||||
in which our community can create great things together.
|
||||
|
||||
Accordingly, we've developed a set of [community standards](/community-standards), which all contributors
|
||||
are expected to follow.
|
||||
|
||||
## Governance
|
||||
|
||||
Lix is developed by a community of passionate users! We have no "benevolent dictator for life",
|
||||
nor a small foundation board that governs the community. Instead, **we rely on teams of our developers
|
||||
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
|
||||
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
|
||||
chat platform commonly used among open-source projects.
|
||||
|
||||
### Lix Matrix
|
||||
|
||||
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 Resources
|
||||
|
||||
In order to help folks who are getting started or who want to learn more about Lix, we've created a curated
|
||||
list of [community resources](/community) that you may find helpful. If you have suggestions, feel free to
|
||||
drop them in our Matrix chat!
|
||||
104
content/faq.md
Normal file
104
content/faq.md
Normal file
|
|
@ -0,0 +1,104 @@
|
|||
---
|
||||
title: "Frequently Asked Questions"
|
||||
description: "frequently is, of course, relatively speaking"
|
||||
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
|
||||
you're looking for, please feel free to ask over in the [community](/community).
|
||||
|
||||
<br/>
|
||||
|
||||
#### Q: Can I use my existing Nix/NixOS configuration?
|
||||
|
||||
Absolutely. A primary goal of the Lix project is compatibility, which means that we very much support
|
||||
using Lix in any existing Nix or NixOS configuration.
|
||||
|
||||
Check out the [install page](/install) to see how to use Lix with your existing configurations.
|
||||
|
||||
#### 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
|
||||
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.
|
||||
|
||||
_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 --
|
||||
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
|
||||
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_,
|
||||
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.
|
||||
|
||||
#### Q: How does Lix work? How can I contribute or help out?
|
||||
|
||||
The Lix codebase is comprised of a few parts, which you can see a description of
|
||||
[here](https://wiki.lix.systems/link/18) along with what we want to improve in them. We also have a
|
||||
lot of areas we are working on other than C++ code that we would love help on, from documentation to
|
||||
compiling lists of resources, web design, bug tracker triage, and more. If you're looking for an idea
|
||||
to get started on, we have triaged some tasks
|
||||
[that we believe should be straightforward](https://git.lix.systems/lix-project/lix/issues?q=&type=all&sort=&state=open&labels=157&milestone=0&project=0&assignee=0&poster=0). To read more
|
||||
about which tasks we recommend taking on, see
|
||||
[Freezes and recommended contributions](https://git.lix.systems/lix-project/lix/issues?q=&type=all&sort=&state=open&labels=157&milestone=0&project=0&assignee=0&poster=0).
|
||||
|
||||
Feel free to ask for help in the Lix development channel. Especially feel free to ask for us to write down
|
||||
more work that we would like help with, or to write contribution information that is missing;
|
||||
it is a goal of the project for it to be easy to get up to speed. Also, if you need additional access to
|
||||
do some task, such as fixing a typo in the wiki, let us know and we will figure it out.
|
||||
|
||||
#### Q: How do I submit changes to the Lix project?
|
||||
|
||||
Feel free to ask for help in the Lix development channel. Especially feel free to ask for us to write down
|
||||
more work that we would like help with, or to write contribution information that is missing; it is a goal
|
||||
of the project for it to be easy to get up to speed. Also, if you need additional access to do some task,
|
||||
such as fixing a typo in the wiki, let us know and we'll figure it out.
|
||||
|
||||
It is also possible to submit changes as normal GitHub pull requests on lix-project/lix. These are also
|
||||
welcome, and we will FIXME convert them to Gerrit changes for you for review. However, there are limitations
|
||||
to the GitHub flow such as PRs needing to be squashed into one change. For larger changes than about 150 lines
|
||||
of normal code, or if necessary, we may ask for a change to be submitted to Gerrit directly so we can review
|
||||
it commit-by-commit.
|
||||
|
||||
|
||||
#### Q: What is a Lix account? What do I need one for?
|
||||
Lix has a central accounts system for all its services. These accounts allow access to Forgejo (the Lix bug tracker
|
||||
and repositories), Gerrit Code Review, the wiki and other collaboration software we use.
|
||||
|
||||
To get started contributing to Lix, you need a Lix account. The easiest way to obtain one is to use GitHub
|
||||
for login, as it will let you get started immediately. We also have local accounts available for those who
|
||||
wish not to use GitHub; if you would like one, please speak to a member of the Lix team on Matrix and we
|
||||
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
|
||||
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.
|
||||
|
||||
|
||||
#### Q: What does the name Lix stand for? How is it pronounced?
|
||||
|
||||
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;
|
||||
which may or may not be stacked up with lambdas.
|
||||
|
|
@ -44,7 +44,7 @@ Members (in alphabetical order):
|
|||
- **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.
|
||||
|
||||
- **raito ([@RaitoBezarius](https://github.com/RaitoBezarius), he/they)**
|
||||
- **raito ([@RaitoBezarius](https://github.com/RaitoBezarius), he/him)**
|
||||
Raito is working on nixpkgs packaging, infrastructure, and review in Lix.
|
||||
They are a Tvix developer focusing on the store and the evaluator.
|
||||
|
||||
|
|
@ -66,11 +66,26 @@ and to recuse themselves from any leadership decisions affected.
|
|||
As transparency is important, we've included declarations from each core team member regarding any possible
|
||||
conflicts of interest.
|
||||
|
||||
- **hexchen** <mark>TODO</mark>
|
||||
- **hexchen**
|
||||
hexchen's employer and its sister companies use Nix/Lix internally and offer Nix-based consulting.
|
||||
hexchen has no stake in the company, does not work in the consulting teams and there is no
|
||||
expectation for her to contribute to Lix on company time. **Should a governance decision involving
|
||||
these or any other financial ties arise, hexchen will recuse herself from decision-making.**
|
||||
|
||||
- **Irenes** <mark>TODO</mark>
|
||||
- **Irene Knapp** (they/them) is the technology director of Internet Safety Labs (ISL), a US-based 501(c)(3)
|
||||
non-profit. To the best of Irene's knowledge, ISL has no financial involvement with any Lix or Nix
|
||||
effort or organization, other than its own internal infrastructure.
|
||||
Irene is also involved in an advisory capacity with the Coworker Solidarity Fund, a US-based 501(c)(4).
|
||||
**Should a governance decision involving these or any other financial ties arise, Irene will recuse themselves
|
||||
from decision-making.** Additionally, while the following does not fall within the scope of any reasonable
|
||||
conflict of interest policy and is not within the scope of the recusal promise,
|
||||
Irene chooses to affirm that they have many personal ties to trans, disabled and
|
||||
neurodivergent tech workers, and are involved with providing and encouraging peer support to same.
|
||||
Irene views the broader queer, disabled, and neurodivergent communities as the primary people to whom
|
||||
they are responsible as an activist, regardless of whatever other affiliations they may have.
|
||||
|
||||
- **jade** <mark>TODO</mark>
|
||||
- **Jade** is currently not working on anything else relevant to Lix development.
|
||||
- She thus declares that she has **no conflicts of interest** regarding the governance of Lix.
|
||||
|
||||
- **Kate Temkin** is the CEO and one-third owner of **Tactile Metrology LLC (TMLLC)**, a company that currently
|
||||
sponsors Lix development. TMLLC declares that it has no financial stake in the future of Lix or Nix,
|
||||
|
|
@ -80,17 +95,24 @@ conflicts of interest.
|
|||
|
||||
- **Lunaphied** declare that they have **no conflicts of interest** regarding the governance of Lix.
|
||||
|
||||
- **pennae** <mark>TODO</mark>
|
||||
- **pennae** declare that they have **no conflicts of interest** regarding the governance of Lix.
|
||||
|
||||
- **puck** <mark>TODO</mark>
|
||||
- **Puck** is working on a NLnet project involving Nix. Should a governance decision involving relevant
|
||||
financial interests arise, she will recuse herself from the relevant decision-making.
|
||||
|
||||
- **Qyriad** is a one-third owner of **Tactile Metrology LLC (TMLLC)**, a company that currently
|
||||
sponsors Lix development. TMLLC declares that it has no financial stake in the future of Lix or Nix,
|
||||
no ties to the military-industrial-complex, and a strong commitment to avoiding such ties. TMLLC is
|
||||
owned by individuals, and not VC investors. Qyriad accordingly declares she has **no conflicts of interest**
|
||||
regarding governance of Lix.
|
||||
owned by individuals, and not VC investors. **Should any decision arise in which TMLLC's interests are
|
||||
relevant, Qyriad will recuse herself from the relevant decision-making**.
|
||||
|
||||
- **raito** <mark>TODO</mark>
|
||||
- **raitobezarius** declares that he's self-employed in a cooperative, offers Nix-based consulting and training.
|
||||
He has currently no stake in the cooperative, though this will change soon. He's also employed by INRIA until
|
||||
August 2024 on Rust formal verification matters. **Should a governance decision involving these or any other
|
||||
financial ties arise, raitobezarius will recuse himself from decision-making.**
|
||||
Additionally, raitobezarius is co-president of DGNum (dgnum.eu), a French "loi 1901" nonprofit organization
|
||||
aiming to promote the parisian Ecole Normale Superieure (45 rue d'Ulm, 75005 Paris) excellence on computer
|
||||
science using heavily Nix/NixOS based technologies.
|
||||
|
||||
- **wiggles** <mark>TODO</mark>
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue