!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

355 Members
Discussion about documentation improvements around the Nix ecosystem87 Servers

Load older messages


SenderMessageTime
23 Jun 2021
@blaggacao:matrix.orgDavid Arnold (blaggacao)
$ installation git:(master) cat *.xml | wc -l
1491
21:38:00
@blaggacao:matrix.orgDavid Arnold (blaggacao) ryantm: what's the solution now for nested includes? 21:56:52
@blaggacao:matrix.orgDavid Arnold (blaggacao)(within a regular md document)21:57:04
@ryantm:matrix.orgryantmI haven't made something to commit yet but I have an example of how to make it work with the top-level release notes file: https://github.com/ryantm/nixpkgs/commit/aa6b6594ef8f940169b9b426040d0259fd1bc88221:58:03
@blaggacao:matrix.orgDavid Arnold (blaggacao)alright let's go that way21:58:40
@ryantm:matrix.orgryantmThat commit changes the release notes from an appendix to a chapter.21:59:36
@ryantm:matrix.orgryantmI don't think Pandoc supports appendices.21:59:52
@ryantm:matrix.orgryantmIt's probably not worth changing the top-level release notes file until we do the final transition.22:00:31
@blaggacao:matrix.orgDavid Arnold (blaggacao)
In reply to @ryantm:matrix.org
It's probably not worth changing the top-level release notes file until we do the final transition.
It at least shows hot it's to be done...
22:01:36
@blaggacao:matrix.orgDavid Arnold (blaggacao)
In reply to @ryantm:matrix.org
It's probably not worth changing the top-level release notes file until we do the final transition.
* It at least shows how it's to be done...
22:03:27
@jtojnar:matrix.orgJan Tojnarwe can always add support for appendices to pandoc 😉22:39:28
@blaggacao:matrix.orgDavid Arnold (blaggacao)
In reply to @blaggacao:matrix.org
It at least shows how it's to be done...
For example for this: https://github.com/NixOS/nixpkgs/pull/127962
23:07:54
24 Jun 2021
@ryantm:matrix.orgryantm Yes, but we'll need to make those changes to the md-to-db.sh too. I can do that in a separate earlier PR though. 01:25:32
@roberthensing:matrix.orgRobert Hensing (roberth) joined the room.16:45:14
@roberthensing:matrix.orgRobert Hensing (roberth) would anyone like to review my pr with lib.sources docs? It's more than docs, but I'm running out of ideas for where to pitch it :/ https://github.com/NixOS/nixpkgs/pull/124875 16:50:31
@ryantm:matrix.orgryantm roberth: The documentation aspect of the changes look okay to me. 18:04:07
26 Jun 2021
@grahamc:nixos.org@grahamc:nixos.orgchanged room power levels.01:18:46
@grahamc:nixos.org@grahamc:nixos.org invited @mjolnir:nixos.orgNixOS Moderation Bot.01:25:43
@mjolnir:nixos.orgNixOS Moderation Bot joined the room.01:25:44
@ryantm:matrix.orgryantmAdded a bunch more easy TODO issues to https://github.com/NixOS/nixpkgs/projects/37 please grab one and help out!17:47:58
@ryantm:matrix.orgryantmhttps://discourse.nixos.org/t/happy-docsgiving/10214/28?u=ryantm latest uodate18:12:38
@ryantm:matrix.orgryantm* https://discourse.nixos.org/t/happy-docsgiving/10214/28?u=ryantm latest update18:12:44
@domenkozar:matrix.orgDomen Kožar Thanks for the amazing work ryantm (as always) :) 18:18:51
27 Jun 2021
@blaggacao:matrix.orgDavid Arnold (blaggacao)This is pure anti-stress workout. Guaranteed!01:10:21
@blaggacao:matrix.orgDavid Arnold (blaggacao)(I'm not yet stressed enough, again) 😆01:10:58
28 Jun 2021
@rummik:matrix.org*Kim joined the room.11:12:32
29 Jun 2021
@infinisil:matrix.orginfinisil joined the room.04:55:56
@pixelfog:matrix.orgpixelfog joined the room.18:43:23
2 Jul 2021
@irenes:matrix.orgIrenes joined the room.21:37:34
3 Jul 2021
@jtojnar:matrix.orgJan Tojnar ryantm: I wonder if we maybe could add docbook output to mmdoc and then use that instead of pandoc at build time, instead of committing the generated XML files 12:52:11

Show newer messages


Back to Room ListRoom Version: 6