!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

449 Members
Discussion about documentation improvements around the Nix ecosystem95 Servers

Load older messages


SenderMessageTime
3 May 2023
@manheraz:matrix.org@manheraz:matrix.org left the room.05:17:48
@kranzes:matrix.org@kranzes:matrix.org joined the room.19:23:13
@federicodschonborn:matrix.org@federicodschonborn:matrix.org joined the room.23:57:04
4 May 2023
@zmitchell:matrix.org@zmitchell:matrix.org Learning journey working group meets in 45 minutes 12:16:08
@fricklerhandwerk:matrix.orgfricklerhandwerkThanks again everyone for joining. We were a bit scattered today due to availability, but thanks to everyone's input we made good progress on how to deal with how-to guides in the foreseeable future.15:04:45
@pennae:matrix.eno.spacepennaeoh, right, meeting 😖15:05:14
@fricklerhandwerk:matrix.orgfricklerhandwerkWe'll write down a few things that have to be done to get going with curating guides in a more structured fashion based on today's discussion. And then we will probably need lots of help to sift through what's out there and bringing that up to date.15:06:22
@j-k:matrix.orgj-ksorry I was only there briefly, getting back into the swing of things after some distracted weeks of work15:34:34
@infinisil:matrix.orginfinisilOh btw this is what I was thinking of regarding the prerequisites of a knowledge graph: https://en.wikipedia.org/wiki/Maximal_and_minimal_elements15:59:52
@infinisil:matrix.orginfinisilOnly the maximal elements of the subgraph of everything that is a prerequisite should be listed16:01:02
@j-k:matrix.orgj-kimage.png
Download image.png
16:03:38
5 May 2023
@infinisil:matrix.orginfinisilI don't think I'll be able to make Monday meetings anymore unfortunately, there's a conflict with another company meeting that tends to have precedence15:51:16
6 May 2023
@duanin2:duanin2.top@duanin2:duanin2.top left the room.19:10:52
8 May 2023
@infinisil:matrix.orginfinisilThe other event was moved, so I'll be there today :)13:10:16
@infinisil:matrix.orginfinisilThough it was moved to the same time as the learning journey meeting on Thursday..13:12:51
@infinisil:matrix.orginfinisilBut I do think 3 hours of meetings per week is too many anyways. We don't seem to make enough progress every week to need so many13:13:02
@zmitchell:matrix.org@zmitchell:matrix.orgIs there a meeting happening today at all?14:04:25
@infinisil:matrix.orginfinisil zmitchell: Yes now :) 14:04:33
@pennae:matrix.eno.spacepennaecouldn't make the meeting, but we did see that y'all are discussing getting rid of epub?15:34:51
@pennae:matrix.eno.spacepennae for some context: we can only drop docbook from any rendered docs as soon as all uses of docbook (including the epub rendering) has been either dropped or replaced 15:36:38
@pennae:matrix.eno.spacepennaeif we keep epub around for however long it takes to deprecate it we'll be saddled with docbook awfulness for at least another year15:37:04
@pennae:matrix.eno.spacepennae(assuming that nobody shows up and adds docbook export to nixos-render-docs, which at this point does not seem likely to happen)15:37:43
@fricklerhandwerk:matrix.orgfricklerhandwerk pennae: what do you think about adding a big deprecation note to every page of the ePub output and wait for someone to complain? If no one uses it we may as well drop it. 18:59:36
@pennae:matrix.eno.spacepennae no clue how to even do that 19:00:15
@pennae:matrix.eno.spacepennaethe entire epub rendering chain is some cursed docbook nonsense19:00:26
@i97henka:matrix.orghenrik-chSorry, also didn't make the meeting today - day off with family in the UK. See you all on Thursday. 19:01:07
@asymmetric:matrix.dapp.org.ukasymmetrici think we should drop docbook, and if someone is willing to add back support for it in nrd, they should do it. there will always be a handful of users who use a niche feature, but if that's not easy to support by the people actually doing the work (pennae in this case), then it should be dropped19:01:50
@asymmetric:matrix.dapp.org.ukasymmetric * i think we should drop epub, and if someone is willing to add back support for it in nrd, they should do it. there will always be a handful of users who use a niche feature, but if that's not easy to support by the people actually doing the work (pennae in this case), then it should be dropped19:01:55
@pennae:matrix.eno.spacepennae a big deprecation notice will also mean that we'll have to keep docbook around for another six to twelve months :/ 19:02:48
@pennae:matrix.eno.spacepennaemmdoc has an epub export, heavy inspiration could be taken from that19:03:51

Show newer messages


Back to Room ListRoom Version: 6