!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

413 Members
Discussion about documentation improvements around the Nix ecosystem81 Servers

Load older messages


SenderMessageTime
30 Dec 2023
@asymmetric:matrix.dapp.org.ukasymmetric Robert Hensing (roberth): about https://github.com/NixOS/nixpkgs/pull/167670#issuecomment-1872501084, do you mean that you'd like to see more documentation before this is exposed to users? 10:54:19
@asymmetric:matrix.dapp.org.ukasymmetric * Robert Hensing (roberth): about https://github.com/NixOS/nixpkgs/pull/167670#issuecomment-1872501084, do you mean that you'd like to see more documentation before this is exposed to lots users via 2023 recap? 10:54:32
@asymmetric:matrix.dapp.org.ukasymmetric * Robert Hensing (roberth): about https://github.com/NixOS/nixpkgs/pull/167670#issuecomment-1872501084, do you mean that you'd like to see more documentation before this is exposed to lots of users via 2023 recap? 10:54:42
@roberthensing:matrix.orgroberthJust to set expectations in the recap10:54:44
@roberthensing:matrix.orgroberthI think it's sufficiently documented10:54:53
@roberthensing:matrix.orgroberthThough maybe the part about it consisting of a single derivation isn't actually10:55:34
@roberthensing:matrix.orgroberthhmm10:55:38
@asymmetric:matrix.dapp.org.ukasymmetric Robert Hensing (roberth): afaict this is ready to be merged, do you agree? https://github.com/NixOS/nixpkgs/pull/277171 11:42:19
@asymmetric:matrix.dapp.org.ukasymmetricif so i'll reopen and merge11:42:22
@roberthensing:matrix.orgroberthmaybe I overreacted. The pr was probably fine11:43:52
@mcdonc:matrix.orgChris McDonough asymmetric: i have something of a competing PR (a bit silly) at https://github.com/NixOS/nixpkgs/pull/277534 ... i think it atually addresses most of your comments, but likely none of Robert's 12:17:51
@mcdonc:matrix.orgChris McDonoughi think it improves on the original PR by specifying whether the derivaion produced will be a file or a directory, and demonstrates how you might use bare writeTextFile to do the job of each writeText*/writeScript*/writeShellScript* function12:20:16
@mcdonc:matrix.orgChris McDonoughit also breaks out each function into a top-level thing12:20:52
@mcdonc:matrix.orgChris McDonoughah nevermind i did not notice it was already merged. i will propose another pr against master.12:24:47
@mcdonc:matrix.orgChris McDonoughor was it? i guess he just closed it instead.12:29:52
@julienmalka:matrix.orgJulien changed their display name from Julien - DECT 4575 to Julien.18:43:51
@raitobezarius:matrix.orgraitobezarius changed their display name from raitobezarius (DECT 2128) to raitobezarius.19:53:20
31 Dec 2023
@aos1:matrix.orgaos Hey y'all - quick question: is there a way to build the nixpkgs manual using the provided flake? I see in https://github.com/NixOS/nixpkgs/blob/34d3d09834b52db5da25fb6f36055f4971709ee3/flake.nix#L57-L62 that the output: htmlDocs is exposed, but I don't think it's possible to build it? I tried nix build .#htmlDocs on a local checkout of nixpkgs repo, but that doesn't work 17:28:51
@danielsidhion:nixos.devdanielsidhion
In reply to @aos1:matrix.org
Hey y'all - quick question: is there a way to build the nixpkgs manual using the provided flake? I see in https://github.com/NixOS/nixpkgs/blob/34d3d09834b52db5da25fb6f36055f4971709ee3/flake.nix#L57-L62 that the output: htmlDocs is exposed, but I don't think it's possible to build it? I tried nix build .#htmlDocs on a local checkout of nixpkgs repo, but that doesn't work
htmlDocs is not a derivation - the error you got when running nix build .#htmlDocs says exactly that. If you look at the definition of htmlDocs in the flake, you'll see it specifies the nixpkgsManual and nixosManual attributes, and those are derivations you can build
17:36:55
@danielsidhion:nixos.devdanielsidhion Try nix build .#htmlDocs.nixpkgsManual or nix build .#htmlDocs.nixosManual 17:37:12
@aos1:matrix.orgaosOhhh... that makes total sense. I should've read the error better. Thank you :-)17:38:17
@philiptaron:matrix.orgPhilip Taron (UTC-8) changed their display name from Philip Taron to Philip Taron (UTC-8).18:10:48
1 Jan 2024
@nixinator:nixos.dev@nixinator:nixos.dev left the room.22:37:04
2 Jan 2024
@asymmetric:matrix.dapp.org.ukasymmetrichttps://jvns.ca/blog/2024/01/01/some-notes-on-nixos/11:19:49
@asymmetric:matrix.dapp.org.ukasymmetrici always find it useful to see what other people use to learn (how to do things with) nix, that's why i post it here11:25:57
@asymmetric:matrix.dapp.org.ukasymmetricit would be good to track how many new articles use nix.dev instead of the wiki. this uses the wiki11:26:55
@asymmetric:matrix.dapp.org.ukasymmetricbut for something that i'm not sure we should be maintaining ourselves? it seems like for things like "nixos friendly hosters", a wiki provides less friction11:27:48
@asymmetric:matrix.dapp.org.ukasymmetric * but for something that i'm not sure we should be maintaining ourselves? it seems like for low-stakes (?) things like "nixos friendly hosters", a wiki provides less friction11:27:57
@asymmetric:matrix.dapp.org.ukasymmetric * but for something that i'm not sure we should be maintaining ourselves? it seems like for low-stakes (?) things like "nixos friendly hosters", a wiki provides less friction for users and takes off some work from the docs team 11:28:18
@asymmetric:matrix.dapp.org.ukasymmetricor is the idea that everything that's now in nix.wiki + nixlang.wiki should eventually be absorbed by nix.dev?11:28:52

Show newer messages


Back to Room ListRoom Version: 6