!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

417 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
8 Nov 2022
@fricklerhandwerk:matrix.orgfricklerhandwerk * https://nixos.org/hydra/manual/ seems to redirect to the latest build of the manual22:39:52
10 Nov 2022
@npc_projection:matrix.orgnpc_projection joined the room.06:56:21
@npc_projection:matrix.orgnpc_projection set a profile picture.07:14:48
11 Nov 2022
@evils.devils:matrix.orgevils left the room.21:52:43
14 Nov 2022
@b:chreekat.netchreekatit appears that lib.mdDoc fails to create paragraphs. For example, services.nginx.virtualHosts.<name>.listen has a paragraph in the input, but not in the output09:53:31
@b:chreekat.netchreekat
  • on search.nixos.org
09:53:40
@b:chreekat.netchreekat

Heh, this one file has two ways of referring to options:

{option}`option.name`

and [](#option.name).

the latter magically makes a link that curiously works. The former is ... also curious

10:14:41
@b:chreekat.netchreekatAnd the file I'm editing uses all three: the two above, plus the nullary "no formatting at all" XD10:15:23
@b:chreekat.netchreekatAny opinions on which I should use?10:15:36
@b:chreekat.netchreekat *

Heh, this one file has two ways of referring to options:

{option}`option.name`

and [](#opt-option.name).

the latter magically makes a link that curiously works. The former is ... also curious

10:19:02
@b:chreekat.netchreekat {option} seems nicer, assuming some day it gets the same treatment as the link 10:20:08
@b:chreekat.netchreekatI'm just not gonna touch it. The unformatted "option" is actually an attribute set10:23:32
15 Nov 2022
@vdemeester:nitro.chatvdemeester joined the room.14:24:53
@seapat:matrix.orgseapat joined the room.17:57:02
@joerg:thalheim.ioMic92What is the current recommendation for generating module documentation: https://github.com/nix-community/disko#module-options ?18:32:41
@yuki:backalley.clubYuki (they/them) Would be nice if we have a tool like godoc 20:05:34
@yuki:backalley.clubYuki (they/them)Is that still a thing? I recall like there’s an instance of it which generates API documentation for pretty much most of GitHub20:06:20
16 Nov 2022
@zuckerberg:neet.spacezuckerberg changed their profile picture.15:53:17
@omlet:matrix.orgomlet joined the room.20:34:36
17 Nov 2022
@yuki:backalley.clubYuki (they/them)No docs team meeting today?14:46:39
@joerg:thalheim.ioMic92I think it's still coming up16:28:27
@joerg:thalheim.ioMic92But I am skipping today16:28:31
@omlet:matrix.orgomlet left the room.18:09:32
18 Nov 2022
@asymmetric:matrix.dapp.org.ukasymmetric changed their profile picture.10:10:27
@vcunat:matrix.orgVladimír Čunát joined the room.10:56:56
@vcunat:matrix.orgVladimír ČunátHello... any idea about this channel-blocking issue with nixpkgs docs? https://github.com/NixOS/nixpkgs/pull/199812#issuecomment-131961107010:57:36
@vcunat:matrix.orgVladimír ČunátI suppose we could un-document the function for now, or try some other random hack, but perhaps some of you will easily understand what's happening.10:58:24
@anderson_torres:matrix.orgAnderson Torres set a profile picture.17:30:16
@anderson_torres:matrix.orgAnderson Torres changed their profile picture.17:30:54
21 Nov 2022
@nogerine:matrix.orgnogerine joined the room.21:41:19

There are no newer messages yet.


Back to Room ListRoom Version: 6