!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

438 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
1 Feb 2022
@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
@hexa:lossy.networkhexaRedacted or Malformed Event17:43:26
@hexa:lossy.networkhexa *
nixpkgs-build-manual () {
	NIX_PATH=nixpkgs=$(pwd) nix-build --option restrict-eval true nixos/release.nix -A manual.x86_64-linux
}
17:43:29
@toonn:matrix.orgtoonn hexa: Not the Nixpkgs manual, the Nix manual. 17:48:40
@toonn:matrix.orgtoonn Or is this the Nix manual, just through Nixpkgs? 17:48:54
@toonn:matrix.orgtoonn But then how does that pick up my changes? 17:49:03
@hexa:lossy.networkhexaHence removed17:49:11
@toonn:matrix.orgtoonn Ah, that doesn't render in an obvious way in my client >.< 17:51:12
@toonn:matrix.orgtoonn Thanks for trying anyway! 17:51:30
@toonn:matrix.orgtoonn Oh no, nix-build -A defaultPackage.x86_64-darwin.doc seems to be build Nix as well : ( 17:53:43
@toonn:matrix.orgtoonn *building 17:53:50
@b:chreekat.netchreekatIn my experience, Nix builds are mostly optimized for CI rather than REPL 18:07:14
@b:chreekat.netchreekatSo you were probably on the right path earlier, trying to find the right combination of nix-shell and build tool18:08:05
@toonn:matrix.orgtoonn I think the nix-shell should suffice but I can't figure out the right make invocation : / 20:22:54
@toonn:matrix.orgtoonn This seems like quite the papercut making contributing to the Nix docs not for mere mortals tbh : / 20:23:25
16 Feb 2022
@b:chreekat.netchreekatAsk on discourse; I'm sure somebody somewhere knows 16:23:47
17 Feb 2022
@signal-walker:matrix.orgAsh joined the room.13:48:12
18 Feb 2022
@cw:kernelpanic.cafeChinchilla Washington changed their display name from Chuck Winter to Chuck Winter (vi/vim).04:12:15
@cw:kernelpanic.cafeChinchilla Washington changed their display name from Chuck Winter (vi/vim) to Chuck Winter.04:20:42

Show newer messages


Back to Room ListRoom Version: 6