!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

391 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 72 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
10 Oct 2024
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * One of the big painpoints also the multipage rendering. getpsyched Working on that. afaik.
Other painpoint is that we have so many entry points, (nixos-, nixpkgs-, nix- manual, nix.dev)
This adds a whole new dimension, but could be solved with a smart navigation system on a single static website.
10:27:11
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @johannes.kirschbauer:scs.ems.host
One of the big painpoints also the multipage rendering. getpsyched Working on that. afaik.
Other painpoint is that we have so many entry points, (nixos-, nixpkgs-, nix- manual, nix.dev)
This adds a whole new dimension, but could be solved with a smart navigation system on a single static website.
Unifying everything in terms of navigation is not even a technical or design problem — in fact we’ll hopefully be able to make some good progress on the design end of November at the ZHF hackathon in Zurich — but it’s actually blocked on unclear ownership (Is the marketing team still fully operational? Last time I tried to reduce the number of sources of truth it got blocked, but we rarely see activity otherwise.) and a lack of people with enough availability to implement decisions once they’re made.
10:39:37
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @brunbjerg:matrix.org

Hello community,

Is there a kind of roadmap for the documentation?

Or a place that is the most in need of updating?

Kind regards

The most up to date that we have in terms of global vision: https://discourse.nixos.org/t/a-roadmap-for-the-documentation-ecosystem/42328
10:41:02
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @johannes.kirschbauer:scs.ems.host
One of the big painpoints also the multipage rendering. getpsyched Working on that. afaik.
Other painpoint is that we have so many entry points, (nixos-, nixpkgs-, nix- manual, nix.dev)
This adds a whole new dimension, but could be solved with a smart navigation system on a single static website.
* Unifying everything in terms of navigation is not even an insurmountable technical or design problem — in fact we’ll hopefully soon be able to make some good progress on the design, end of November at the ZHF hackathon in Zurich — but it’s actually blocked on unclear ownership (Is the marketing team still fully operational? Last time I tried to reduce the number of sources of truth it got blocked, but we rarely see activity otherwise.) and a lack of people with enough availability to implement decisions once they’re made.
10:41:46
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostMaybe it would Help If we could ask for Money. Like CTF, each task gets a reward of lets say 1k-2k or sth. We have the Vision, the milestones. Just Lack of Motivation from enough people. 10:52:08
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostMaybe we can raise a pot of Money for all the Framework and infra refactoring Tasks. 10:59:59
@p4cmanus3r:matrix.orgp4cmanus3r joined the room.13:26:17
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @johannes.kirschbauer:scs.ems.host
Maybe we can raise a pot of Money for all the Framework and infra refactoring Tasks.

Yes, we can put up a funding goal on https://opencollective.com/nixos/projects/nix-documentation

Just need to define concrete, achievable deliverables.

14:27:17
@requiem33:matrix.orgrequiem33 joined the room.22:40:04
15 Oct 2024
@detroyejr:matrix.orgdetroyejr joined the room.02:55:49
@pyrox:pyrox.devdish [Fox/It/She] joined the room.03:21:33
@marshmallow:althaea.zone@marshmallow:althaea.zone joined the room.06:17:43
@lassulus:lassul.uslassulus joined the room.07:45:33
@unaboomer_:matrix.orgunaboomer_ joined the room.08:11:17
17 Oct 2024
@tiagod:matrix.orgtdillenburg changed their display name from tiagod to tdillenburg.01:41:41
@dmills27:matrix.orgDominic Mills set a profile picture.17:15:08
@ronef:matrix.orgronefHey, every NixCon I do a collaborative "State of the Union" where folks from various efforts/teams come share a slide for two minutes and a call to action. Thought to check if someone from the docs team might be interested and is coming to NixCon!20:55:27
19 Oct 2024
@jwillikers:matrix.orgjwillikers joined the room.12:09:32

Show newer messages


Back to Room ListRoom Version: 6