!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

402 Members
Discussion about documentation improvements around the Nix ecosystem81 Servers

Load older messages


SenderMessageTime
31 Mar 2024
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host
In reply to @alejandrosame:matrix.org
Sharing a screenshot of the WIP work on the nixpkgs manual Python section.
Not sure but i think i am somewhat working on this indirectly. I am doing value introspection. Which seems to be the same here. But i try to do a more generic approach to find all lambdas, lambda arguments, functors, and so on recursively for any nix expression. Will take some time though until it is done
18:32:36
@skiparoo:matrix.orgskippy joined the room.20:35:10
@dclmatrix:matrix.org@dclmatrix:matrix.org changed their display name from dclmatrix to exet.22:32:54
@technicus:matrix.orgMiles Dyson joined the room.23:07:02
1 Apr 2024
@paperdigits:matrix.org@paperdigits:matrix.org joined the room.03:24:41
@paperdigits:matrix.org@paperdigits:matrix.orgSo is nrd its own extension of github flavored markdown?03:30:08
@lennart:0520.chlennart (this account will be deactivated by 1st of may 2025) changed their display name from lennart to lennart (this account will be deactivated by 1st of may 2025).04:43:52
@pennae:matrix.eno.space@pennae:matrix.eno.space
In reply to @paperdigits:matrix.org
So is nrd its own extension of github flavored markdown?
more a combination of commonmark (because the documentation rfcs specified commonmark as the language to use), gfm features, myst features, and a few custom additions. it doesn't support all gfm features, but it does support tables. the rest isn't all that useful for the nixos/nixpkgs manual usecase (task lists aren't useful in a non-interactive setting and can be rendered differently anyway, in general shouldn't be used because parts render out to manpages and can't support html, etc).
12:21:44
@fricklerhandwerk:matrix.orgfricklerhandwerkhttps://discourse.nixos.org/t/wiki-nixos-org-is-now-live/4257014:05:53
@ners:nixos.devnersimage.png
Download image.png
14:07:00
@ners:nixos.devnersunacceptable14:07:03
@sandro:supersandro.deSandroWikimedia shenanigans 14:29:05
@ners:nixos.devnersIt's ok, I managed to snag 𝐧𝐞𝐫𝐬. Unicode my beloved.14:31:30
@ners:nixos.devnersExcited to contribute to this wiki. I always thought it was the best hope for properly documenting Nix.14:31:55
@ners:nixos.devners * Excited to contribute to this wiki. I always thought it was the best hope for properly documenting the Nix ecosystem.14:32:03
@paperdigits:matrix.org@paperdigits:matrix.orgOh... That sounds problematic.14:40:56
@adam:robins.wtf@adam:robins.wtf"technical restrictions"15:00:32
@philiptaron:matrix.orgPhilip Taron (UTC-8)I tried to add the documentation team to https://github.com/NixOS/nixpkgs/pull/300745 but failed (and removed a couple GitHub added people in doing so.)17:55:56
@connorbaker:matrix.orgconnor (burnt/out) (UTC-8) joined the room.19:12:31
@danielsidhion:nixos.devdanielsidhionNew RFC which is relevant for us: https://github.com/NixOS/rfcs/pull/174 I haven't read through it all, but adding it as a topic of discussion for the next meeting. Given it's a bit long, I'm bringing awareness now so we can give it a read before the next meeting23:29:27
2 Apr 2024
@waltermoreira:matrix.orgwaltermoreira joined the room.05:07:50
@infinisil:matrix.orginfinisilI honestly don't think the wiki is going to "save" documentation. It's just going to be another resource with potentially duplicate and outdated information, not much changed from previous wiki attempts21:48:56
@infinisil:matrix.orginfinisilhttps://wiki.nixos.org/wiki/NixOS_Wiki:History gives a great overview21:49:34
@shalokshalom:kde.org@shalokshalom:kde.org left the room.21:51:18
@terru:raccoon.college@terru:raccoon.college joined the room.23:28:51
3 Apr 2024
@jvns:matrix.orgb0rk changed their display name from Julia Evans to b0rk.01:23:26
@paperdigits:matrix.org@paperdigits:matrix.org left the room.05:10:40
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @infinisil:matrix.org
I honestly don't think the wiki is going to "save" documentation. It's just going to be another resource with potentially duplicate and outdated information, not much changed from previous wiki attempts
It can work if Someone(tm) takes the time to curate it. As I argued on the GitHub issue, we do have huge gaps in terms of user guides for NixOS, and this is where the Wiki would be actually useful - as long as it's limited to that.
11:05:51
@fricklerhandwerk:matrix.orgfricklerhandwerk

https://github.com/NixOS/nix-pills/pull/233

henrik-ch what do you think? I probably will at most listen in on Thursday, but maybe we should just merge that one.

12:58:22
@dclmatrix:matrix.org@dclmatrix:matrix.org changed their display name from exet to blu3.16:01:34

Show newer messages


Back to Room ListRoom Version: 6