!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

419 Members
Discussion about documentation improvements around the Nix ecosystem85 Servers

Load older messages


SenderMessageTime
29 Mar 2024
@shalokshalom:kde.org@shalokshalom:kde.orgAh, a Hickey video I dont know yet ^^07:04:09
@danielsidhion:nixos.devdanielsidhion

infinisil asked as to come back to answer questions regarding the tooling, we've yet to hear one

As for this, I wanted to have that spreadsheet filled out before engaging in review, and then in its discussion, where questions and discussion about the tooling would be most important (and having the fresh discussion would be helpful IMO). I haven't had enough time to dedicate lately to filling out the sheet. It's something that will get done eventually as I put more effort in.

07:07:41
@danielsidhion:nixos.devdanielsidhion
In reply to @shalokshalom:kde.org
Ah, a Hickey video I dont know yet ^^
It's a pretty good one. I'm currently reading the book he recommends on the socratic method and it's been pretty good as well
07:09:07
@danielsidhion:nixos.devdanielsidhion(I just updated the spreadsheet to reflect that gfm tables are supported for nrd, and the rest of it if we implement it. I think it's a better reflection of the facts. Thank you again for calling it out)07:11:18
@efx:matrix.orgefxthat book sounds fantastic :)15:13:09
@efx:matrix.orgefxsilly question: as a contributor, when I make changes to a nixpkgs language markdown file, how do I easily test the manual generates correctly?15:13:40
@efx:matrix.orgefxI'm on NixOS too15:13:46
@shalokshalom:kde.org@shalokshalom:kde.org
In reply to @danielsidhion:nixos.dev
(I just updated the spreadsheet to reflect that gfm tables are supported for nrd, and the rest of it if we implement it. I think it's a better reflection of the facts. Thank you again for calling it out)
where can I see this spreadsheet please?
15:20:33
@fricklerhandwerk:matrix.orgfricklerhandwerkRedacted or Malformed Event15:21:44
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @efx:matrix.org
silly question: as a contributor, when I make changes to a nixpkgs language markdown file, how do I easily test the manual generates correctly?
*
cd doc
nix-shell
devmode

15:22:25
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @efx:matrix.org
silly question: as a contributor, when I make changes to a nixpkgs language markdown file, how do I easily test the manual generates correctly?
cd doc
nix-shell
devmode
15:23:38
@efx:matrix.orgefx
In reply to @fricklerhandwerk:matrix.org
cd doc
nix-shell
devmode
many thanks! I've noted that in my PR testing: https://github.com/NixOS/nixpkgs/pull/300019#issuecomment-2027388055
15:31:15
@danielsidhion:nixos.devdanielsidhion
In reply to @shalokshalom:kde.org
where can I see this spreadsheet please?
It's at https://ethercalc.net/dc4vcnnl8zv0
22:08:00
@shalokshalom:kde.org@shalokshalom:kde.orgthx23:44:16
30 Mar 2024
@ajcxz0:matrix.org@ajcxz0:matrix.org joined the room.00:41:00
@ivank:matrix.orgivan joined the room.04:15:31
31 Mar 2024
@dclmatrix:matrix.org@dclmatrix:matrix.org joined the room.18:01:32
@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.spacepennae
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.deSandro 🐧Wikimedia shenanigans 14:29:05
@ners:nixos.devnersIt's ok, I managed to snag 𝐧𝐞𝐫𝐬. Unicode my beloved.14:31:30

Show newer messages


Back to Room ListRoom Version: 6