!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

338 Members
Discussion about documentation improvements around the Nix ecosystem83 Servers

Load older messages


SenderMessageTime
17 Jun 2021
@artturin:matrix.orgartturin set a profile picture.00:11:39
19 Jun 2021
@leo:gaspard.ninjaEkleog joined the room.01:02:46
@ncfavier:matrix.orgnf joined the room.06:49:56
@nbardiuk:matrix.orgnazarii left the room.20:16:36
22 Jun 2021
@megamanmalte:retinker.demegamanmalte joined the room.09:43:46
@b:chreekat.netbryan joined the room.16:27:58
@princemachiavelli:matrix.orgprincemachiavelli joined the room.16:31:29
@blaggacao:matrix.orgDavid Arnold I guess the problem wit list-prs-for-file is the 25 pull request lmiit: https://github.com/sindresorhus/refined-github/pull/2197/files#diff-26e829c321ccba564beb4bb33adb6e5a71106315a1e35b430d5dd1d7b383aa05R64 17:10:05
@blaggacao:matrix.orgDavid Arnoldhahahahahahahahahaha17:10:08
@blaggacao:matrix.orgDavid Arnold * I guess the problem wit list-prs-for-file is the 25 pull request limit: https://github.com/sindresorhus/refined-github/pull/2197/files#diff-26e829c321ccba564beb4bb33adb6e5a71106315a1e35b430d5dd1d7b383aa05R64 17:10:17
@blaggacao:matrix.orgDavid Arnold What an easy fix on nixpkgs side 17:10:25
@blaggacao:matrix.orgDavid Arnold🤣😂17:10:32
@blaggacao:matrix.orgDavid Arnold * I guess the problem wit list-prs-for-file is the 25 pull request limit: https://github.com/sindresorhus/refined-github/pull/2197/files#diff-26e829c321ccba564beb4bb33adb6e5a71106315a1e35b430d5dd1d7b383aa05R64 17:10:43
@blaggacao:matrix.orgDavid Arnold (at least we now have a technical argument to ramp up the stalebot) 17:55:06
23 Jun 2021
@ryantm:matrix.orgryantmI figured out how to convert the top-level release-notes.xml file to markdown by getting embedded docbook includes to work: https://github.com/ryantm/nixpkgs/commit/aa6b6594ef8f940169b9b426040d0259fd1bc88203:49:16
@ryantm:matrix.orgryantmThis should be useful for the sections of the NixOS manual that are more deeply nested than the Nixpkgs manual.03:55:56
@blaggacao:matrix.orgDavid Arnold
In reply to @ryantm:matrix.org
I figured out how to convert the top-level release-notes.xml file to markdown by getting embedded docbook includes to work: https://github.com/ryantm/nixpkgs/commit/aa6b6594ef8f940169b9b426040d0259fd1bc882
Maybe the sphinx .. include:: ../README.md is already more familiar to use. There is also Paradox' @@include README.md
11:45:25
@blaggacao:matrix.orgDavid Arnold* Maybe the sphinx' `.. include:: ../README.md` is already more familiar to use. There is also Paradox' `@@include README.md`11:45:34
@blaggacao:matrix.orgDavid ArnoldRedacted or Malformed Event11:46:17
@blaggacao:matrix.orgDavid ArnoldRedacted or Malformed Event11:54:51
@blaggacao:matrix.orgDavid Arnold0. `.. include:`11:55:02
@blaggacao:matrix.orgDavid Arnold[Poll] Which? 0. .. include: myfile.md 1. @@include myfile.md11:55:45
@blaggacao:matrix.orgDavid Arnold0. .. include: myfile.md11:55:46
@blaggacao:matrix.orgDavid ArnoldI also enjoyed reading https://developer.lightbend.com/docs/paradox/current/directives/index.html12:28:07
@blaggacao:matrix.orgDavid Arnold Especially the @snip directive: 12:29:46
@blaggacao:matrix.orgDavid Arnold
@@snip [sysctl.nix](/nixos/sysctl.nix) { #label_filter }
12:31:57
@blaggacao:matrix.orgDavid ArnoldWhere label filter is a comment syntax to demark the code region to include into the docs.12:32:27
@blaggacao:matrix.orgDavid ArnoldThose code regions will be tested by hydra, and when the code updates, code regions will have to be updated, too.12:33:03
@blaggacao:matrix.orgDavid ArnoldSo less documentation drift.12:33:10
@blaggacao:matrix.orgDavid Arnold* Where label filter is a code comment syntax to demark the code region to include into the docs.12:33:37

Show newer messages


Back to Room ListRoom Version: 6