!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

434 Members
Discussion about documentation improvements around the Nix ecosystem91 Servers

Load older messages


SenderMessageTime
30 Jan 2022
@joepie91:pixie.townjoepie91 🏳️‍🌈yeah that section looked weirdly empty to me00:26:46
@joepie91:pixie.townjoepie91 🏳️‍🌈couldn't really derive any understanding from it00:26:59
@jtojnar:matrix.orgJan Tojnarlooks like it might only extract C style-comments00:27:25
@jtojnar:matrix.orgJan Tojnarrather than the shell-style ones00:27:33
@joepie91:pixie.townjoepie91 🏳️‍🌈there's at least one misparse too00:27:36
@jtojnar:matrix.orgJan Tojnarwhich are used for most docs in the sources.nix00:27:50
@joepie91:pixie.townjoepie91 🏳️‍🌈under 5.1.4.4. lib.trivial.concat00:27:51
@joepie91:pixie.townjoepie91 🏳️‍🌈alright, I've been at this for 8-9 hours and it's nearly bedtime so I gotta detach now :p feel free to leave any further review comments and/or questions and I'll read them in the morning00:29:38
@joepie91:pixie.townjoepie91 🏳️‍🌈or what passes as 'morning' for me anyway00:29:52
@joepie91:pixie.townjoepie91 🏳️‍🌈(thanks, btw!)00:44:18
@jtojnar:matrix.orgJan Tojnarany comments on https://github.com/NixOS/nixpkgs/pull/157336?19:09:44
@asymmetric:matrix.dapp.org.ukasymmetric i'm just a bit confused about why you switched some multilines to #, e.g. in lib/trivial.nix, but then also converted some single-line comments to /* ... */ 19:20:47
@asymmetric:matrix.dapp.org.ukasymmetric * Jan Tojnar: i'm just a bit confused about why you switched some multilines to #, e.g. in lib/trivial.nix, but then also converted some single-line comments to /* ... */ 19:21:04
@asymmetric:matrix.dapp.org.ukasymmetric ah, is it that comments inside code are now always with #? 19:21:37
@jtojnar:matrix.orgJan Tojnar asymmetric: yeah, nixdoc extracts c-style comments and ignores shell-style ones 19:22:07
1 Feb 2022
@aktaboot:matrix.orgaktaboot joined the room.01:01:57
@aktaboot:matrix.orgaktaboot

Hey ! Just some feedback:

I felt that it was weird that the manuals where not easily accessible from the website.

You have to go to Learn and then scroll all the way down to see them.

Some links to the docs in the headers or/and the footers, visible on all pages would be more intuitive imo.

09:22:46
@aktaboot:matrix.orgaktaboot *

Hey ! Just some feedback:

I felt that it was weird that the manuals were not easily accessible from the website.

You have to go to Learn and then scroll all the way down to see them.

Some links to the docs in the headers or/and the footers, visible on all pages would be more intuitive imo.

09:22:57
@aktaboot:matrix.orgaktaboot *

Hey ! Just some feedback:

I felt that it was weird that the manuals were not easily accessible from the website.

You have to go under Learn and then scroll all the way down to see them.

Some links to the docs in the headers or/and the footers, visible on all pages would be more intuitive imo.

09:23:17
@aktaboot:matrix.orgaktabootPlus, I am not even sure where the links to nixos.wiki are on the nixos.org website.12:10:35
@aktaboot:matrix.orgaktabootoh nvm it's unofficial12:11:20
@coolshaurya:community.rscoolshaurya joined the room.16:47:08
2 Feb 2022
@cw:kernelpanic.cafeChinchilla Washington changed their display name from CoilWinder (novus ordo seclorum) to Chuck Winter.08:36:41
4 Feb 2022
@jonringer:matrix.orgjonringerPing again, I would really like to move fowrad on https://github.com/NixOS/nixpkgs/pull/15635518:36:27
6 Feb 2022
@aktaboot:matrix.orgaktaboot left the room.19:53:34
8 Feb 2022
@galactic_starfish:kde.orggalactic_starfish joined the room.00:57:31
15 Feb 2022
@toonn:matrix.orgtoonn Anyone know how to build the Nix docs? I've entered a nix-shell in the Nix repo but `make doc/manual/index.html` doesn't seem to be the correct target. 17:15:10
@joepie91:pixie.townjoepie91 🏳️‍🌈 toonn: I very vaguely recall that there's specifically an attribute exported by nixpkgs for building the docs 17:20:07
@joepie91:pixie.townjoepie91 🏳️‍🌈in the same way there's an attribute for building a release somewhere17:20:19
@toonn:matrix.orgtoonn I could build just the doc output for Nix I guess. But I'd rather not build any unnecessary things like the manpages if I can avoid it. 17:21:11

Show newer messages


Back to Room ListRoom Version: 6