!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

366 Members
Discussion about documentation improvements around the Nix ecosystem85 Servers

Load older messages


SenderMessageTime
13 Sep 2024
@phanirithvij:matrix.orgloudgolem joined the room.09:49:28
16 Sep 2024
@viperml:ayats.orgFernando joined the room.09:37:51
@viperml:ayats.orgFernando hello, how do I get a link to one of the nix manual sections, that is not bound to an specific nix version? I want to get the latest derivations page, not specific to 2.18 https://nix.dev/manual/nix/2.18/language/derivations 09:39:17
@toonn:matrix.orgtoonn Fernando: I think you can substitute `stable` for the version number. 10:01:45
@viperml:ayats.orgFernandoperfect, thank you11:36:24
@viperml:ayats.orgFernandoperhaps it could be useful to have some little icon at the bottom of the page or something, that copies that 😄11:36:52
@silentlurker:matrix.orgsilentlurker joined the room.20:00:48
17 Sep 2024
@penguincoder:matrix.wolfie.pw@penguincoder:matrix.wolfie.pw left the room.14:40:10
@tomherbers:matrix.orgTom (deprecated) joined the room.21:10:41
18 Sep 2024
@viperml:ayats.orgFernando hello again, I believe pkgs.writers are not documented in the nixpkgs manual 🤔 13:02:52
23 Sep 2024
@phanirithvij:matrix.orgloudgolem nix-build --check flag is not documented in nix manual https://nix.dev/manual/nix/latest/command-ref/nix-build.html 09:05:30
@phanirithvij:matrix.orgloudgolemit is refrenced here https://nix.dev/manual/nix/latest/advanced-topics/diff-hook#spot-checking-build-determinism09:06:41
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @phanirithvij:matrix.org
nix-build --check flag is not documented in nix manual https://nix.dev/manual/nix/latest/command-ref/nix-build.html
Thanks for the pointer. Please open an issue on GitHub so we don't lose track of it
09:27:52
@phanirithvij:matrix.orgloudgolemok I will check if any existing issues exist or create one09:29:48
@phanirithvij:matrix.orgloudgolemRedacted or Malformed Event09:31:16
@phanirithvij:matrix.orgloudgolem * seems there is one already by you, https://github.com/NixOS/nix/issues/798109:31:30
@phanirithvij:matrix.orgloudgolem
In reply to @fricklerhandwerk:matrix.org
Thanks for the pointer. Please open an issue on GitHub so we don't lose track of it
seems there is one already by you, https://github.com/NixOS/nix/issues/7981
09:33:06
@fricklerhandwerk:matrix.orgfricklerhandwerkAh thanks, I didn't find it on a quick skim09:34:42
@phanirithvij:matrix.orgloudgolemwhat is the current ongoing documentation effort, I mean what is being worked on? where can I follow it?09:39:22
@phanirithvij:matrix.orgloudgolemok I found what has been done recently https://discourse.nixos.org/search?q=This%20Month%20in%20Nix%20Docs%20in%3Atitle%20order%3Alatest_topic09:49:36
@phanirithvij:matrix.orgloudgolemalso https://github.com/orgs/NixOS/projects/15/views/114:09:44
@elikoga:matrix.orgelikoga joined the room.15:30:54
@connorbaker:matrix.orgconnor (he/him) (UTC-7) changed their display name from connor (he/him) (UTC-5) to connor (he/him) (UTC-7).17:57:39
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @phanirithvij:matrix.org
what is the current ongoing documentation effort, I mean what is being worked on? where can I follow it?
It’s been a bit quiet around the team recently, and the project board is out of date. There are a few isolated efforts here and there, and I keep reviewing PRs. Any help is greatly appreciated - if you want to pick up or start something, we can supply all the information you need to get going
18:59:37
@phanirithvij:matrix.orgloudgolem
In reply to @fricklerhandwerk:matrix.org
It’s been a bit quiet around the team recently, and the project board is out of date. There are a few isolated efforts here and there, and I keep reviewing PRs. Any help is greatly appreciated - if you want to pick up or start something, we can supply all the information you need to get going
I've added a broken link checker github workflow to nixos wiki infra recently and plan to do something similar to find broken/outdated links in nixpkgs as a maintainer script.
20:38:42
@phanirithvij:matrix.orgloudgolemlet me know if there is something similar already, I couldn't find it in my brief search20:39:45
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @phanirithvij:matrix.org
I've added a broken link checker github workflow to nixos wiki infra recently and plan to do something similar to find broken/outdated links in nixpkgs as a maintainer script.
In the Nixpkgs and NixOS manuals, internal references are already checked. You could run lychee impurely to check external links though
20:40:55
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @phanirithvij:matrix.org
I've added a broken link checker github workflow to nixos wiki infra recently and plan to do something similar to find broken/outdated links in nixpkgs as a maintainer script.
* In the Nixpkgs and NixOS manuals, internal references are already checked by the rendering engine. You could run lychee impurely to check external links though
20:41:05
@phanirithvij:matrix.orgloudgolem yes, external links in manuals is what I was thinking, also checking meta.homepage meta.changelog if possible for all packages 20:42:12
@fricklerhandwerk:matrix.orgfricklerhandwerk

The Nix manual could need help with internal references though:

  • https://github.com/NixOS/nix/issues/10313
  • https://github.com/NixOS/nix/pull/11306
20:43:26

Show newer messages


Back to Room ListRoom Version: 6