!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

383 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 71 Servers

Load older messages


SenderMessageTime
13 Apr 2024
@infinisil:matrix.orginfinisil
In reply to @terru:raccoon.college
fair enough (should it be an outright error or just a trace for now?). if nothing else comes up i'd open a PR with this built on then-current master sometime tomorrow
You can use lib.warn (which gives a trace) :)
13:36:52
@terru:raccoon.college@terru:raccoon.collegei know. my question was more: should it give a trace, or should it give a hard (failing) error directly?13:38:22
@terru:raccoon.college@terru:raccoon.collegebut i'll use lib.warn if that's preferred (just be a second, I was literally just writing the PR message for this 😄)13:39:15
@infinisil:matrix.orginfinisilAnswered on GitHub: https://github.com/NixOS/nixpkgs/pull/299409#issuecomment-205365022513:41:19
@infinisil:matrix.orginfinisil(it can work)13:41:35
@infinisil:matrix.orginfinisil terru: Yeah just a trace for now is my preference 13:42:04
@terru:raccoon.college@terru:raccoon.collegefair13:45:27
@terru:raccoon.college@terru:raccoon.collegeyou should've gotten a ping from github with the PR ;)13:45:56
@terru:raccoon.college@terru:raccoon.college * you should've just gotten a ping from github with the PR ;)13:46:00
@terru:raccoon.college@terru:raccoon.college grr forgot the final force-push changing the throw to lib.warn, sorry to everyone who now got pinged twice 🙈 13:48:16
@alex3829:matrix.org@alex3829:matrix.org joined the room.16:04:39
14 Apr 2024
@windchimesofmagic:matrix.org@windchimesofmagic:matrix.org left the room.17:37:29
15 Apr 2024
@soenke:hack-hro.desoenke joined the room.22:08:57
16 Apr 2024
@thoth101010:matrix.orgthoth joined the room.09:02:05
17 Apr 2024
@alex3829:matrix.org@alex3829:matrix.org changed their display name from alex3829 to real_z22.04:36:12
@alex3829:matrix.org@alex3829:matrix.org changed their display name from real_z22 to real_z2.05:33:42
@JoelMcCracken:matrix.orgJoelMcCracken joined the room.16:26:38
18 Apr 2024
@fractivore:cyberia.club@fractivore:cyberia.club left the room.02:27:17
@nscnt:matrix.org@nscnt:matrix.org joined the room.13:21:24
@olafklingt:matrix.org@olafklingt:matrix.orghow is the ":::" annotation called in sphinx? i wonder what the implications of more or less periods is.17:42:57
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @olafklingt:matrix.org
how is the ":::" annotation called in sphinx? i wonder what the implications of more or less periods is.
Admonition
18:10:51
@terru:raccoon.college@terru:raccoon.college oh btw, while we're talking about admonitions: the doc/README.md still contains links to docbook for the types of admonitions which are supported. Is this in any way useful or intentional, or just a migration leftover and therefore a bug? (I found it a little confusing when i noticed it) 19:55:09
19 Apr 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @terru:raccoon.college
oh btw, while we're talking about admonitions: the doc/README.md still contains links to docbook for the types of admonitions which are supported. Is this in any way useful or intentional, or just a migration leftover and therefore a bug? (I found it a little confusing when i noticed it)
Probably a leftover. Feel free to remove the links
08:59:31
@terru:raccoon.college@terru:raccoon.collegesure: https://github.com/NixOS/nixpkgs/pull/30532815:10:08
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @terru:raccoon.college
sure: https://github.com/NixOS/nixpkgs/pull/305328
Thanks!
15:28:02
@terru:raccoon.college@terru:raccoon.college (and while we are on the topic of leftover docbook mentions: anyone got opinions on this issue of mine?) 15:29:11
@djacu:matrix.orgdjacu fricklerhandwerk: infinisil I've created an issue for expanding and improving the module documentation on nix.dev. I would appreciate your and anyone else's feedback.
https://github.com/NixOS/nix.dev/issues/966
16:34:01
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @terru:raccoon.college
(and while we are on the topic of leftover docbook mentions: anyone got opinions on this issue of mine?)
Yeah just ditch those references. Thanks a lot!
17:10:29
@olafklingt:matrix.org@olafklingt:matrix.org I started to think/brainstorm about the NixOS manual again. And i remember that fricklerhandwerk recently said that he thinks "a lot of things in the manual should be on the wiki". What was did you had in mind with of that statement? 19:15:31
@terru:raccoon.college@terru:raccoon.college
In reply to @fricklerhandwerk:matrix.org
Yeah just ditch those references. Thanks a lot!
have opened a PR removing it
19:29:59

Show newer messages


Back to Room ListRoom Version: 6