!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

351 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation NixOS teams calendar: https://calendar.google.com/calendar/embed?src=b9o52fobqjak8oq8lfkhg3t0qg%40group.calendar.google.com Documentation office hours are open for anyone interested in solving problems, getting contributions reviewed in real time, or becoming a maintainer. Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 80 Servers

Load older messages


SenderMessageTime
30 Aug 2024
@philiptaron:matrix.orgPhilip Taron (UTC-8) *

Johannes Kirschbauer @hsjobeki: for nixdoc so that it gets picked up in noogle.dev, where do I land the documentation?

I'm specifically interested in fetchFromGitHub. Is it above the lib.makeOverrideable?

17:39:53
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiUnfortunately this is one Edge Case where noogle canot yet find the source Position. Correct Position would be above the function or above the attribute name 17:42:52
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiNot above makeOverridable that would be docs for makeOverridable.17:44:14
@philiptaron:matrix.orgPhilip Taron (UTC-8)
In reply to @johannes.kirschbauer:scs.ems.host
Unfortunately this is one Edge Case where noogle canot yet find the source Position.
Correct Position would be above the function or above the attribute name
Attribute name meaning the one in pkgs/top-level/all-packages.nix?
17:48:42
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiI'd prefer to have the Docs at the Position that you get when applying the function with wrong Arguments. (The Lambda Position) I am traveling right now cant send the exact position. You'll figure it out 😀17:59:01
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiAh should say that you should Look at the stacktrace 18:03:47
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobekiI have some plans how we could find the correct position but honestly maybe WE should just have a list of edge case functions 18:05:16
@johannes.kirschbauer:scs.ems.hostJohannes Kirschbauer @hsjobeki* I have some plans how we could find the correct position but honestly maybe we should just have a list of edge case functions 18:08:31
1 Sep 2024
@zzantares:matrix.org@zzantares:matrix.org removed their display name Hamlet'sPiedPlumber.19:19:33
@zzantares:matrix.org@zzantares:matrix.org left the room.19:20:00
3 Sep 2024
@djacu:matrix.orgdjacu left the room.23:29:31
5 Sep 2024
@jackleightcap:matrix.orgJack Leightcap joined the room.03:43:28
@philiptaron:matrix.orgPhilip Taron (UTC-8)Anyone else reproduce this issue? https://github.com/NixOS/nixpkgs/issues/33980818:32:39
@philiptaron:matrix.orgPhilip Taron (UTC-8)I wasn't able to.18:32:43
@djacu:matrix.orgdjacu joined the room.19:30:23
@enn_:matrix.orgenn_
In reply to @philiptaron:matrix.org
I wasn't able to.

I was unable to repro, but did notice that my configuration appears to have sandbox set to false:

nix-shell -p nix-info --run "nix-info -m"                                                                                                              0:21:25
 - system: `"aarch64-darwin"`
 - host os: `Darwin 23.6.0, macOS 14.6.1`
 - multi-user?: `yes`
 - sandbox: `no`
 - version: `nix-env (Nix) 2.24.0pre20240709_142e566a`
 - channels(root): `"nixpkgs"`
 - nixpkgs: `/Users/ewannisbet/.nix-defexpr/channels/nixpkgs`

using nix build --option sandbox true github:nixos/nixpkgs/master#nixpkgs-manual also didn't report errors, but I'm not familiar enough to know if I should expect to be able to enable sandbox like that

23:25:29
6 Sep 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk

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?

08:39:47
9 Sep 2024
@nakibrayan:tchncs.de@nakibrayan:tchncs.de joined the room.02:06:18
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.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

Show newer messages


Back to Room ListRoom Version: 6