Skip to content

Bootstrap governance page #1864

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open

Bootstrap governance page #1864

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
d0ea5af
bootstrap governance page
thilobillerbeck Oct 8, 2025
73af5af
some small touchups
thilobillerbeck Oct 8, 2025
1e10fef
update box with team info
thilobillerbeck Oct 8, 2025
954c4e5
fix headline spacing
thilobillerbeck Oct 11, 2025
566bea1
update team work description
thilobillerbeck Oct 21, 2025
86915cc
Update core/src/pages/governance.astro
thilobillerbeck Oct 21, 2025
a11f944
Update core/src/pages/governance.astro
thilobillerbeck Oct 21, 2025
3a2587f
show team member github => discourse => real name
thilobillerbeck Oct 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions core/astro.config.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,9 @@ export default defineConfig({
vite: {
plugins: [tailwindcss()],
},
redirects: {
'/values': '/governance',
},
env: {
schema: {
THEME: envField.string({
Expand Down
9 changes: 7 additions & 2 deletions core/src/components/ui/Quotation.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,14 @@
---

const { dark } = Astro.props;
---

<div
class="bg-secondary-afghani-blue-95 text-secondary-afghani-blue-15 rounded-3xl p-8 font-bold"
class:list={[
'my-4 rounded-xl p-8 font-bold',
dark
? 'dark bg-secondary-afghani-blue-35 text-secondary-afghani-blue-95!'
: 'bg-secondary-afghani-blue-95 text-secondary-afghani-blue-15',
]}
>
<slot />
</div>
4 changes: 2 additions & 2 deletions core/src/content/menus/header.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ items:
link: /download
- name: Learn
link: /learn
- name: Values
link: /values
- name: Governance
link: /governance
- name: Community
link: /community
- name: Blog
Expand Down
315 changes: 315 additions & 0 deletions core/src/pages/governance.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,315 @@
---
import Container from '../components/layout/Container.astro';
import Divider from '../components/layout/Divider.astro';
import PageHeader from '../components/layout/PageHeader.astro';
import Layout from '../layouts/Layout.astro';

import Quotation from '@/components/ui/Quotation.astro';
import { getCollection, getEntry } from 'astro:content';
import Citation from '../components/ui/Citation.astro';

const teams = await getCollection('teams');
const foundationBoard = await getEntry('teams', '010_foundation-board');
const steeringCommittee = await getEntry('teams', '000_steering-committee');
---

<Layout title="Governance">
<PageHeader text="Governance" />
<Container class="py-8 leading-relaxed font-extralight">
<h2
class="font-heading text-secondary-afghani-blue mt-8 text-4xl font-bold"
>
Nix Leadership Bodies
</h2>
<p class="mb-6">The Nix community is guided by two leadership bodies:</p>
<div class="mt-2 mb-3 grid gap-4 md:grid-cols-2">
<div
class="bg-secondary-afghani-blue-95 flex w-full flex-col gap-2 rounded-xl p-4"
>
<h3
class="font-heading text-secondary-afghani-blue text-3xl leading-none font-bold"
>
The Steering Committee
</h3>
<span class="text-secondary-afghani-blue-35 text-lg">
7 elected individuals to represent the community
</span>
<span>
<b>Responsibilities:</b> Technical and community decisions and delegation
</span>
<span>
<b>Members:</b>
{
steeringCommittee.data.members
.map((member) => member.name)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be better to use GitHub handles (with a link), because that's more recognisable

.join(', ')
}
</span>
<a href="/community/teams/steering-committee">More Info</a>
</div>
<div
class="bg-secondary-afghani-blue-95 flex w-full flex-col gap-2 rounded-xl p-4"
>
<h3
class="font-heading text-secondary-afghani-blue text-3xl leading-none font-bold"
>
The Foundation Board
</h3>
<span class="text-secondary-afghani-blue-35 text-lg">
Board members of the Stichting NixOS Foundation, a non-profit
organisation in Utrecht, the Netherlands
</span>
<span>
<b>Responsibilities:</b> Legal, financial and partnership decisions and
delegation
</span>
<span>
<b>Members:</b>
{foundationBoard.data.members.map((member) => member.name).join(', ')}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same for the board

</span>
<a href="/community/teams/foundation-board">More Info</a>
</div>
</div>
<p>
Behind these bodies are many volunteers who contribute to the project in
various ways. Read more about our {teams.length} teams on the <a
href="/community">community page</a
>.
</p>
<h3
class="font-heading text-secondary-afghani-blue mt-4 text-3xl font-bold"
>
Governance Constitution
</h3>
<p class="mb-2">
The <a href="https://github.com/NixOS/org/blob/main/doc/constitution.md"
>Nix Governance Constitution</a
> describes each bodies responsibilities, how the steering committee is elected,
and how decisions are made inside the steering committee.
</p>
<h3
class="font-heading text-secondary-afghani-blue mt-4 text-3xl font-bold"
>
Steering Committee Elections
</h3>
<p class="mb-2">
Every year, the Nix community elects members to the steering committee.
Each member holds a two-year term, with elections held annually to fill
half of the seats. You can read more about the election process in the <a
href="https://github.com/NixOS/org/blob/main/doc/constitution.md"
>Nix Governance Constitution</a
>.
</p>
<p>
The elections are documented in GitHub repositories under the <a
href="https://github.com/NixOS">NixOS organization</a
>.
</p>
<p>
<b>Current and past elections:</b>
<a href="https://github.com/NixOS/SC-election-2025">2025</a>, <a
href="https://github.com/NixOS/SC-election-2024">2024</a
>
</p>
</Container>
<Divider mirrorY />
<div
class="bg-secondary-afghani-blue-45 text-primary-white py-8 font-extralight"
>
<Container class="space-y-2">
<h2
class="font-heading text-primary-white mt-4 text-4xl font-bold"
id="community-values-intro"
>
Values
<a href="#community-values-intro" class="text-lg">🔗</a>
</h2>

<Quotation dark>
<p>
Communities form when different people unite around a common purpose.
Shared values guide decision making, and community goals supersede
individual interests and agendas.
</p>

<p class="py-2 text-right italic">
<a href="https://opensource.com/open-source-way" class="text-lg"
>The Open Source Way</a
>
</p>
</Quotation>

<p>
Our common purpose is to develop, propagate, and promote the adoption of
the <a href="https://edolstra.github.io/pubs/phd-thesis.pdf"
>purely functional software deployment model</a
>. Our values help us achieve this purpose by guiding decisionmaking
across the community, keeping us moving in a common direction. This
document captures our core values so that they can be shared and
referenced by everyone in the community.
</p>

<h3
class="font-heading text-primary-white mt-4 text-3xl font-bold"
id="community-values-whatis"
>
What is a value?
<a href="#community-values-whatis" class="text-lg">🔗</a>
</h3>

<p>
Values are <span class="italic">not</span> a Code of Conduct, they do not
define governance structures, and they do not provide specific policies.
Instead, values inform the decisions we make about these things. A good test
for <a
href="https://medium.com/the-u-s-digital-service/our-values-1fc02b53598"
>whether something is a value</a
> is:
</p>

<Quotation dark>
If a statement can be invoked by anyone in an organization, and cause a
decision to be re-evaluated or changed, without regard to anyone’s rank
or title, then you have a bona fide [i.e. genuine] value. If it doesn’t
work that way, then it’s not a value.
</Quotation>

<p>
To apply in many situations, values must be high-level, abstract
concepts. Therefore, in the text below, each value is presented as a
heading followed by an elaboration of its meaning. This is meant as a
starting point for interpretation, not a comprehensive definition. The
heading and the elaboration have equal importance.
</p>
<h3
class="font-heading mt-4 text-3xl font-bold"
id="community-values-values"
>
The values
<a href="#community-values-values" class="text-lg">🔗</a>
</h3>

<h4
class="font-heading mt-4 text-2xl font-bold"
id="community-values-respect"
>
Respect and civility
<a href="#community-values-respect" class="text-lg">🔗</a>
</h4>

<p>
We treat each other with respect and civility. No matter one's
individual identity, circumstances, level of contribution to the
project, or status, everyone has the right to respect, and everyone has
the duty to treat others with respect. We prioritise project health over
individual interests. People with higher visibility within the project
or towards the public are subject to higher expectations for their
conduct.
</p>

<h4
class="font-heading mt-4 text-2xl font-bold"
id="community-values-people"
>
People come first
<a href="#community-values-people" class="text-lg">🔗</a>
</h4>

<p>
We are here, first and foremost, as individuals working together. Our
priority here is to work on Nix projects for the benefit of all their
contributors and users. We value building excellent software with a
vibrant and diverse community. Individuals gain trust and status by
doing the work. Organisations gain prestige by funding the work of
individuals and providing resources to support the project.
</p>

<h4
class="font-heading mt-4 text-2xl font-bold"
id="community-values-choice"
>
Free software and choice over lock-in
<a href="#community-values-choice" class="text-lg">🔗</a>
</h4>

<p>
Nix projects are and will always remain <a
href="https://www.gnu.org/philosophy/free-sw.en.html"
class="text-primary-white">free software</a
>. We value working together with the broader free software community.
Free software is our priority, but we also support our users' needs to
use non-free software, when practical.
</p>

<h4
class="font-heading mt-4 text-2xl font-bold"
id="community-values-decisionmaking"
>
Distribute decisionmaking widely
<a href="#community-values-decisionmaking" class="text-lg">🔗</a>
</h4>

<p>
We are a synthesis of varied but overlapping communities. We rely on
distributed approaches: asynchronous communication, clear ownership,
deep-dive taskforces, and local decisionmaking. We focus our attention
on working together on our shared goals and working separately in a
non-interfering way when our goals are independent. We build trust
primarily by working together on Nix projects.
</p>

<h4
class="font-heading mt-4 text-2xl font-bold"
id="community-values-automation"
>
Automation over process and toil
<a href="#community-values-automation" class="text-lg">🔗</a>
<Citation id={1} onBlueBackground>
<a
href="https://web.archive.org/web/20240717145635/https://sre.google/sre-book/eliminating-toil/"
>Toil</a
> is work that tends to be manual, repetitive, automatable, interrupt-driven,
devoid of enduring value, and scaling linearly with growth.
</Citation>
</h4>

<p>
We are a global community, and disseminating information and maintaining
processes can be difficult. We are also a large project with a lot of
hard and repetitive work. Therefore, we value automation over toil,
while recognizing that not all toil can be automated. Automation reduces
toil, but people are still accountable. Adding new toil needs a very
strong justification. We build automation and processes that make the
best use of our contributors' limited time and energy.
</p>

<h4
class="font-heading mt-4 text-2xl font-bold"
id="community-values-stability"
>
Stable evolution over stagnation or chaos
<a href="#community-values-stability" class="text-lg">🔗</a>
</h4>

<p>
Openness to new ideas and evolution is part of what made Nix great. We
continue to foster that evolution while encouraging development of
re-usable building blocks and well-defined, stable interfaces. We value
experimenting with designs and concepts, and folding successful
experiments back into continuous improvement for stable components. The
larger the impact an action has, the more care and discussion is
warranted before taking the action. Our leaders have a duty to find,
support, and promote new contributors — and eventually step aside for
new leaders.
</p>
</Container>
</div>
</Layout>

<style>
@reference "./../styles/base.css";

.bg-secondary-afghani-blue-45 a {
@apply hover:text-primary-black-75 text-primary-white;
}
</style>
Loading