Call for volunteers: curating official projects

Hi everyone, this message is written on behalf of the community teams’ representatives.

In the months since NixCon 2023 there have been discussions on how to establish an authoritative collection of “official” projects in the Nix ecosystem. The main goal of such a distinction is to help contributors and users navigate the tooling landscape, and allow them to judge more easily the support status and maturity level of the various components. The hope is to make better use of our most valuable collective resources: attention and effort.

In the April 2024 community teams’ representatives meeting, the attendees discussed the latest proposal for how to approach that, and agreed that individuals should drive the process of curating that collection, as well as refining the selection criteria. We would like at least one person reasonably experienced with the ecosystem to take that responsibility, involve and communicate with all relevant stakeholders, and implement transitions or other changes where needed.

This is an important endeavor that will shape the face of the ecosystem, and the teams will provide support and guidance to anyone who picks up any of the various (largely non-technical) tasks. Activtities could involve asking power users and beginners what they expect from the ecosystem, researching or experimenting with existing solutions, talking with project authors or maintainers about their goals and capacities, proposing changes to repository descriptions or documentation, finding places for the relevant pieces of information, etc.

If you’re interested to help out, please answer here or write me a private message on Discourse or Matrix to get onboarded.

17 Likes

Sounds nice, I would like to participate.

It is too early to say that I think it is more important to set an authoritative Grade on Projects with well-defined rules and sort/categorize the landscape, than make things Official, unless the idea is to move them from Community to Official, and it will have official support from NixOS Org (whatever that means)?

I know that awesome project, have a different view.

My objection to this approach is the popularity bias, that won’t help new projects cold start a network effect, while we are trying to cold start network effect for Nix.

This team is a subset of documentation team?

Some resources for future discussion:
@blaggacao For Workstation vs For Servers, he also mentions Nasa technology readiness levels.

OpenSSF Best Practices Badge and its criteria, and its guide. Linux Foundation measuring your open source program success. Wikipedia list of FLOSS assessment methodologies.

2 Likes

No, it’s a somewhat regular meeting of representatives from all community teams.

There are a few concrete candidates that have been discussed in the documents linked from the past meeting notes, such as Hydra, NixOps, Home Manager, npins, … The idea is to try things out and refine the criteria in the process.

What is that view?

Nice! Synthesizing or maybe even simply picking some of that would be great. We just have to make sure the requirements we choose can actually be met in reality.

I don’t think this is a problem. The criteria are not primarily about popularity but fitness for purpose. Generally the Nix ecosystem does not seem to suffer a lack of popularity, but a lack of high-quality code and documentation.

1 Like

The awesome manifesto

Only awesome is awesome
Research if the stuff you’re including is actually awesome. Only put stuff on the list that you or another contributor can personally recommend. You should rather leave stuff out than include too much.


Depending on whom you ask, Nix has this issue. :sweat_smile:

I at the risk of making things unnecessarily complicated and derailing this topic, I think an “authoritative collection” is going to be more than a simple document and we are going to need something more like database that we can use to create index documents or diagrams like the technology radar.

I asked a friend and they pointed me to an XMPP XEP for something like this: https://xmpp.org/extensions/xep-0453.html

Gathering information on many implementations has always been a chore, there exist various lists or comparisons for XMPP clients, servers and libraries, but these are often out of date, inaccurate, incomplete, or generally unmaintained.

This specification aims at solving this problem by putting the work of publishing and keeping up to date said information onto the maintainers of the software. Given many already do maintain this kind of list, the inconvenience should be minimal.

The information listed SHOULD include, but isn’t limited to, the project name, homepage, description, logo, screenshots if relevant, specifications supported (RFCs and XEPs). A full list of supported properties is described in RDF format at http://usefulinc.com/ns/doap#.

A central point should be defined to gather the list of implementations publishing their information, this specifications proposes xmpp.org for this purpose.

2 Likes

@ehmry, thank you.

Think we have different views:

  • @fricklerhandwerk: a list of official projects
    • handled by the team,
    • curated,
    • whatever official means);
  • Awesome: a list of awesome projects
    • handled by the team
    • curated;
  • @hugosenari: a list of projects
    • handled by the team
    • un-curated;
  • @ehmry: a project indexer
    • handled by project owner,
    • un-curated;

My question is: @fricklerhandwerk what official means to community and to project?

Related?: flake-registry #25 - Policy for inclusion in the flake registry

off-topic: @ehmry my comment in #25 is something like User add a ‘namespace’, 1 flake with all projects like nixpkgs# has all nixpkgs.

I was hoping for something semi-curated. An index that people can submit their projects into. And an index where a team can mark projects with tags like official, mature, best-practices. If there was a “technology radar” this would be a curated map of projects surrounded by an un-curated periphery.

Probably best to just make the damn official list and not worry about ontologies, submission, and document generation.

4 Likes

Yes please, cheaply produce something that can be discussed and iterated on.

@ehmry we had discussed making some sort of structured representation… why not a Nix expression or even a module? We can render anything from there.

I think it’s difficult to make a judgement about which projects are “best”, but one thing you can do is to assess which projects are “healthy” or “mature”. This is how affiliation with software foundations often goes: you have to demonstrate that your project has good documentation, a decent body of contributors, good contribution information, etc. in order to become affiliated. They don’t judge whether the project is any good at what it does… but projects don’t tend to have a healthy body of contributors unless a bunch of people like them!

So I wonder if that’s a better direction to go in. Look at Apache, or Hyperledger, or the OpenSSF Best Practices. Make a list of requirements, use it to certify some projects as “mature”.

As a user this is super useful information. For example, NixOps seems to often be considered official, but in practice is essentially un-maintained. The second fact seems much more important to me.

Separately, having an “awesome” list seems cool. A big list of maybe interesting projects for people to browse around seems also useful.

2 Likes

@michaelpj it depends on what official means. Ie:

  • Recommend in documentation (ie when nix.dev have to talk about pinning),
    • List all only makes newbies more confused.
  • Add to flake-registry,
    • Add all is desirable but see flake-registry#25
  • Give support (financial, work hours, etc),
    • I’d like to give money and commitment to all projects, but resources are limited
  • Make it a nixos org project.
    • Similar to previous but also include author giving the project to NixOS org (like Apache SSF does).
  • Certificate

Sounds good.

I hope most projects have different purposes, then would be a more discussion if we would like to officially support that purpose.

Once we decide purposes and check for alternatives, we can define criteria for each purpose like.

  • Healthy, to be defined
  • Readiness, to be defined
  • Poll?

And reschedule review every X months.

Related discussion unified product and story

“What do we consider part of the Nix ecosystem for the purpose of documentation?”
by @fricklerhandwerk

One tiny step: proposal to move @andir’s npins to nix-community

1 Like