!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

415 Members
Discussion about documentation improvements around the Nix ecosystem87 Servers

Load older messages


SenderMessageTime
29 Mar 2024
@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.orgEli Flanaganthat book sounds fantastic :)15:13:09
@efx:matrix.orgEli Flanagansilly 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.orgEli FlanaganI'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.orgEli Flanagan
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
@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

Show newer messages


Back to Room ListRoom Version: 6