!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

378 Members
Discussion about documentation improvements around the Nix ecosystem90 Servers

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


SenderMessageTime
6 Jul 2024
@fricklerhandwerk:matrix.orgfricklerhandwerkNixOS documentation does not have all that many helping hands, and the user-facing tools are not in great shape, in my opinion. So there are still endless misconceptions implanted into beginners' minds. If you have the time to dig into it and read the source code, I'm there to answer any questions you may encounter, or point you to better places where to ask them.10:25:31
@fricklerhandwerk:matrix.orgfricklerhandwerkAs for flakes, here's an overview: https://nix.dev/concepts/flakes10:26:18
@fricklerhandwerk:matrix.orgfricklerhandwerkThe Nix manual's glossary is only about Nix concepts. Modules, options, packages are Nixpkgs things, but the Nixpkgs manual doesn't have a glossary yet - I'd help getting a first attempt merged! Home Manager has its own documentation (without a glossary): https://nix-community.github.io/home-manager/10:28:53
@fricklerhandwerk:matrix.orgfricklerhandwerkAs for overall structure and discoverability.. yes, that's still an issue. Many people come to the ecosystem through NixOS, but there's really no one maintaining the user experience there. I've been taking things from the bottom up for the past two years, guiding people who start with Nix on an existing system, and I think things have improved. But NixOS just has very different requirements, and one needs to think it through and find a place where people can go through that journey. These things are up for grabs, so if you really want to change that and show up consistently, you can take the lead on that.10:32:40
@sliedes:hacklab.fiSami LiedesThanks for the very good explanation :)13:23:44
7 Jul 2024
@jyim:matrix.orgmaj changed their profile picture.21:20:38
8 Jul 2024
@zzantares:matrix.org@zzantares:matrix.org changed their display name from zzantares to demo-reset.06:00:24
@zzantares:matrix.org@zzantares:matrix.org removed their profile picture.06:00:33
@nickkadutskyi:matrix.org@nickkadutskyi:matrix.org left the room.19:20:17
9 Jul 2024
@ktemkin:katesiria.org@ktemkin:katesiria.org left the room.04:59:30
10 Jul 2024
@enn_:matrix.orgenn_
In reply to @proofconstruction:matrix.org
Welcome! For suggestions, typically they are made here, in a GitHub Issue, or by implementing the change and making a pull request to the appropriate repository. In all cases there will be an associated thread of comments and follow up suggestions.
It never fails to surprise me how time flies. This comment is also an attempt to understand how badly I'll spam the main channel when I comment in this thread...
21:34:57
@enn_:matrix.orgenn_Download nix-docs-proposal.md21:37:41
@enn_:matrix.orgenn_
In reply to @enn_:matrix.org
It never fails to surprise me how time flies. This comment is also an attempt to understand how badly I'll spam the main channel when I comment in this thread...
clearly in no particular rush from my side ๐Ÿ˜… I've attached a brief proposal relating to nix docs for consideration. Am happy to come along to an office hours session if that is useful / appropriate, or just receive feedback here, whatever works ๐Ÿ™‚
21:39:27
@zzantares:matrix.org@zzantares:matrix.org changed their display name from demo-reset to Hamlet'sPiedPlumber.23:02:34
11 Jul 2024
@fastloris:tchncs.de@fastloris:tchncs.de left the room.10:53:04
@cafkafk:gitter.imcafkafk changed their profile picture.17:11:22
15 Jul 2024
@willbush:matrix.orgwillbushI was trying to try to help out in the nix.dev repo by going through old issues and seeing if any can be closed or easily fixed. Should I ping someone from the issue if I think it can be closed or just leave a comment or something?00:23:44
@willbush:matrix.orgwillbushRedacted or Malformed Event01:38:24
@willbush:matrix.orgwillbush* I was thinking to try to help out in the nix.dev repo by going through old issues and seeing if any can be closed or easily fixed. Should I ping someone from the issue if I think it can be closed or just leave a comment or something?02:14:13
@willbush:matrix.orgwillbushDownload issues.md05:58:11
@willbush:matrix.orgwillbushI commented on some issues. Here's a list of what I went through: 05:58:14
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @willbush:matrix.org
I was thinking to try to help out in the nix.dev repo by going through old issues and seeing if any can be closed or easily fixed. Should I ping someone from the issue if I think it can be closed or just leave a comment or something?
Hey, thanks for taking the tour! This stuff is very helpful. Itโ€™s best to comment on the issue though. Everyone can see it there and follow up. And for me personally itโ€™s easiest to handle because I get notifications and can take it from there.
06:05:55
@drupol:matrix.orgPol left the room.17:39:40
16 Jul 2024
@alex3829:matrix.org@alex3829:matrix.org left the room.23:17:06
23 Jul 2024
@ezzobirbezziou:matrix.orgEzzobir Bezziou joined the room.08:22:40
24 Jul 2024
@redstone-menace:matrix.orgRedstone changed their display name from redstone-menace to Redstone.10:14:59
26 Jul 2024
@shivaraj:matrix.orgshivaraj-bh set a profile picture.06:40:20

Show newer messages


Back to Room ListRoom Version: 6