!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

435 Members
Discussion about documentation improvements around the Nix ecosystem92 Servers

Load older messages


SenderMessageTime
19 Aug 2022
@jtojnar:matrix.orgJan TojnarAlso the config will also apply to specializations containing specializations (not sure if that is a thing).21:18:22
@rapenne-s:tchncs.deSolène Rapenne (she/her) Jan Tojnar yes this can be inline within the imports but I find it very not practical 21:54:52
@rapenne-s:tchncs.deSolène Rapenne (she/her)I dunno if it could be possible to cover specialisation in man configuration.nix ?22:05:18
@me:linj.techlinj
In reply to @rapenne-s:tchncs.de
that's cool, someone wrote https://nixos.wiki/wiki/Specialisation after my tweag blog post. I added this section because it's a very useful use case but totally impossible to figure out (infinisil found how to do that). Could someone tell me if it's understandable? https://nixos.wiki/wiki/Specialisation#Special_case:_the_default_non-specialised_entry
cool, config.specialisation != {} is a clever hack! I used to use mkRemove to remove items from a list in specialisation.
22:16:44
@jtojnar:matrix.orgJan Tojnar
In reply to @rapenne-s:tchncs.de
Jan Tojnar yes this can be inline within the imports but I find it very not practical
I am somewhat worried about perpetuating the misconception that files are something special (I have seen newcomers confused by this) but I am not how to formulate it better without it becoming too clumsy or more confusing
22:43:07
@rapenne-s:tchncs.deSolène Rapenne (she/her)I still don't understand why the code can't be put into configuration.nix ^^' so I used a file to keep things clean instead of a big chunk into imports22:43:56
20 Aug 2022
@b-eric-d:matrix.orgb-eric-d joined the room.02:33:32
@kayla.fire:matrix.orgkayla (she/they) joined the room.17:25:18
21 Aug 2022
@greaka:greaka.degreaka changed their display name from greaka ⚡️ to greaka .09:25:58
@starf0x7:matrix.orgjurraca changed their display name from jurraca to jeak.18:08:54
22 Aug 2022
@jeicher:matrix.orgJohann Eicher joined the room.09:18:22
23 Aug 2022
@callmeecho:matrix.orgEcho joined the room.00:49:38
@psibi:matrix.orgpsibi joined the room.12:46:30
@raphi:tapesoftware.netraphi joined the room.18:55:49
24 Aug 2022
@portothree:matrix.orgportothree joined the room.13:29:50
@tinybronca:sibnsk.netunderpantsgnome changed their display name from tinybronca to underpantsgnome.23:02:24
25 Aug 2022
@shane:sveller.socialshanesveller joined the room.15:32:54
@fricklerhandwerk:matrix.orgfricklerhandwerkDocs team meeting notes: https://hackmd.io/VbhmPjaeTPSUsPVf-9iB5A15:33:17
@pennae:matrix.eno.spacepennaeis the docbook-to-md migration for modules something the docs team wants to discuss?15:39:34
@a-kenji:matrix.orga-kenji
In reply to @pennae:matrix.eno.space
is the docbook-to-md migration for modules something the docs team wants to discuss?
Is there also somewhere an issue I can look at that shows how it is done?
19:56:37
@pennae:matrix.eno.spacepennae a-kenji: there's no single issue, just us going through the modules and slowly converting the docbook option descriptions to markdown as a first step. after that we'll have to find a renderer to replace the current xsltproc stack (a process that apparently got stuck, https://discourse.nixos.org/t/any-consensus-on-documentation-generation-tool-for-nixpkgs-manual/15550) 19:59:51
@pennae:matrix.eno.spacepennaeprobably won't be too long before the conversion itself is done20:00:38
@a-kenji:matrix.orga-kenji
In reply to @pennae:matrix.eno.space
a-kenji: there's no single issue, just us going through the modules and slowly converting the docbook option descriptions to markdown as a first step. after that we'll have to find a renderer to replace the current xsltproc stack (a process that apparently got stuck, https://discourse.nixos.org/t/any-consensus-on-documentation-generation-tool-for-nixpkgs-manual/15550)
Thanks!
20:01:21
@pennae:matrix.eno.spacepennaewe're hoping to at least have all options converted to MD for the 22.11 release and to have some warning in place for docbook descriptions during a transitional period20:09:20
26 Aug 2022
@denna:matrix.orgolafI found one more book: https://scrive.github.io/nix-workshop/ it's published under https://creativecommons.org/licenses/by-sa/4.0/ 11:05:02
27 Aug 2022
@ehllie:matrix.orgEhllie joined the room.13:09:36
29 Aug 2022
@brianna.g:matrix.orgbrianna.g joined the room.07:04:12
30 Aug 2022
@jakehamilton:matrix.orgjakehamilton joined the room.01:03:35
@aruzeta:matrix.orgaru joined the room.14:41:22
@aruzeta:matrix.orgaru left the room.15:54:40

Show newer messages


Back to Room ListRoom Version: 6