!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

412 Members
Discussion about documentation improvements around the Nix ecosystem86 Servers

Load older messages


SenderMessageTime
10 Sep 2024
@matthewcroughan:defenestrate.itmatthewcroughan changed their display name from matthewcroughan - going to nix.camp to matthewcroughan.15:52:23
11 Sep 2024
@stefanwschroeder:matrix.orgStefan Schroeder
In reply to @fricklerhandwerk:matrix.org

Hi Nix docs people! I'm slowly revamping our Open Collective page and would like to ask for your input: what should we ask our supporters to help make possible?

A couple of months ago we prepared the Google Season of Docs application which, based on some metrics, proposed to write a Docker and cross compilation tutorial each. There's probably more high-value targets that we could make possible with some funding. Things that are too risky to start if it's not someone's job to finish them. What did you always want to have in terms of documentation but didn't dare asking for? What would help you have a better time contributing to documentation?

We have an "Installing Nixos of RPi 4" that says: "With some modifications this would also work on a RPi 3". It would be nice to learn what these are in detail. Furthermore: This tutorial installs on the SBC as if it were a regular machine. But the RPi is pretty low performance. It would be nice to have a tutorial (and this would also extend to non-SBC machines) to explain how to create and tailor a ready-to-run diskimage on a separate, more powerful machine that you can copy to a SD card and run without additional tweaking on the device.
07:47:06
@fricklerhandwerk:matrix.orgfricklerhandwerk Stefan Schroeder: thanks for the feedback! Creating a fully offline installer image would indeed be worthwhile, I've seen people ask it a lot (example). That would be a nice small recipe, and would mesh nicely with the nixos-anywhere tutorial. 07:52:46
@nakibrayan:tchncs.de@nakibrayan:tchncs.de removed their display name Rayan Nakib (ريان نقيب).20:16:17
@nakibrayan:tchncs.de@nakibrayan:tchncs.de left the room.20:16:18
13 Sep 2024
@phanirithvij:matrix.orgloudgolem joined the room.09:49:28
16 Sep 2024
@viperml:ayats.org@viperml:ayats.org joined the room.09:37:51
@viperml:ayats.org@viperml:ayats.org 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.org@viperml:ayats.orgperfect, thank you11:36:24
@viperml:ayats.org@viperml:ayats.orgperhaps 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.org@viperml:ayats.org 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 (burnt/out) (UTC-8) 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

Show newer messages


Back to Room ListRoom Version: 6