!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

404 Members
Discussion about documentation improvements around the Nix ecosystem78 Servers

Load older messages


SenderMessageTime
7 Sep 2021
@ryantm:matrix.orgryantm Mic92: Oh, I was misreading what you said. Yes, we figured out how to use include tags, let me find the syntax. 12:58:57
@ryantm:matrix.orgryantm Mic92: https://github.com/ryantm/nixpkgs/commit/aa6b6594ef8f940169b9b426040d0259fd1bc882 looks like it requires a little change to the generator scripts too. 13:01:18
@ryantm:matrix.orgryantmWe didn't merge that in yet, I think.13:01:31
@mic92:nixos.devMic92@ryantm: any reason not to merge it?13:06:13
@ryantm:matrix.orgryantm Mic92: I don't think so, except maybe it needs to be fixed up. 13:09:06
@ryantm:matrix.orgryantmI'll try to do that now.13:12:36
@ryantm:matrix.orgryantm Mic92: I just remembered why I didn't do it. It was going to convert the Release Notes from an Appendix to a Chapter. 13:23:03
@mic92:nixos.devMic92ryantm: is it not still useful for the remaining docs?13:23:34
@ryantm:matrix.orgryantm Mic92: It is, so I'll make a PR that is just the script changes. 13:24:00
@ryantm:matrix.orgryantm Mic92: Here we go https://github.com/NixOS/nixpkgs/pull/136987/files 13:32:29
@ryantm:matrix.orgryantm * Mic92: Here we go https://github.com/NixOS/nixpkgs/pull/136987/ 13:32:37
@charlotte:vanpetegem.mechvp joined the room.14:51:42
@jtojnar:matrix.orgJan Tojnarhow should we proceed with with https://github.com/NixOS/nixpkgs/pull/130047?18:15:56
@mic92:nixos.devMic92 Jan Tojnar: looks good to me 18:18:19
@mic92:nixos.devMic92is detecting all pages that starts with systemd too much magic?18:19:11
@jtojnar:matrix.orgJan Tojnar Mic92: not sure if all of them have same page number 18:25:56
@mic92:nixos.devMic92 Jan Tojnar: you are right, systemd.directives(7) has the references 18:26:45
@mic92:nixos.devMic92But do you even need the number?18:27:50
@mic92:nixos.devMic92The url does not come with numbers18:27:56
@jtojnar:matrix.orgJan Tojnaryeah, you are right18:28:17
@jtojnar:matrix.orgJan Tojnarwe could probably use regex in the lua script18:28:32
@jtojnar:matrix.orgJan TojnarI wondered if we should keep the mapping dumb (e.g. JSON in case we want to use it from other languages)18:29:44
@jtojnar:matrix.orgJan Tojnarand in the end decided the ability to match patterns might be too useful 18:30:12
@jtojnar:matrix.orgJan Tojnarbut for now, I would probably keep it simple in case we decide we want to use JSON in nixos-search18:33:08
@ryantm:matrix.orgryantmI'm still kind of opposed to adding more syntax just to support this small feature.18:40:07
@mic92:nixos.devMic92does it log us in to pandoc basically?18:41:43
@mic92:nixos.devMic92 * Does it lock us in to pandoc basically?18:41:54
@ryantm:matrix.orgryantmI suspect there are others that support it, but each syntax we adopt add limits our options. I guess it shouldn't be too hard to find all the places using it and change them later though.18:43:12
@jtojnar:matrix.orgJan Tojnarthe syntax comes from MyST (sphinx) but wit pandoc, we can trivially convert it to whatever else we decide on later18:45:10
@mic92:nixos.devMic92would it work with https://github.com/ryantm/mmdoc?18:45:44

Show newer messages


Back to Room ListRoom Version: 6