!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

416 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
4 Apr 2024
@infinisil:matrix.orginfinisil pennae: Yeah, though I'm not sure which email is yours, I can't find a pennae one 15:37:24
@infinisil:matrix.orginfinisilI tried out something new with the google calendar event: I turned off the ability to see who's invited. This was rarely necessary and I believe it's what might be causing the emails getting sent every time a new person is invited15:52:39
@infinisil:matrix.orginfinisil danielsidhion: I just removed somebody inactive from the invites, did you get an update email for that? 15:54:59
@infinisil:matrix.orginfinisil^^ Or anybody else that has been getting update emails before15:55:24
@infinisil:matrix.orginfinisil wamirez: I think you might have gotten update emails in the past, could you check? ^ 16:05:25
@infinisil:matrix.orginfinisil * wamirez: I think you might have gotten update emails in the past, could you check that you don't anymore? ^ 16:05:40
@danielsidhion:nixos.devdanielsidhion
In reply to @infinisil:matrix.org
danielsidhion: I just removed somebody inactive from the invites, did you get an update email for that?
Didn't get any update emails
16:13:33
@infinisil:matrix.orginfinisilNice, I think this might work then16:37:43
@orangepeach:matrix.orgSamir joined the room.19:57:05
@thatoo:matrix.orgThatoo joined the room.21:11:48
5 Apr 2024
@roberthensing:matrix.orgRobert Hensing (roberth) quick thought: maybe reconsider calling everything a manual? Although it seems to be possible to call reference material "manual", the word often refers to more guide-like material 09:33:27
@danielsidhion:nixos.devdanielsidhionI think the term "manual" is orthogonal to the purpose of the material. Both nix and nixpkgs manuals are actually named "reference manual" to explain their purpose (to be a reference). Personally I think the word "guide" is way more popular to refer to guide-like material (e.g. "user guide").10:55:57
@danielsidhion:nixos.devdanielsidhionSometimes people do use the term "manual" in the form "user manual" to refer to guide-like material, though10:56:35
@danielsidhion:nixos.devdanielsidhionDo you have a suggestion that would make things clearer?10:56:58
@danielsidhion:nixos.devdanielsidhionAs for the nixos manual - I'd agree with renaming it to nixos user guide or nixos user manual or something like that10:59:02
@danielsidhion:nixos.devdanielsidhionMaybe "nix(pkgs) reference (material|documentation|book)" and "nixos user guide", and avoid any misunderstanding with the word manual entirely?11:02:36
@anderson_torres:matrix.orgAnderson TorresWhat we have that would be equiv to A handbook?12:59:10
@infinisil:matrix.orginfinisilMaybe just "Nix[pkgs] reference"18:31:47
@anderson_torres:matrix.orgAnderson Torres* What we have that would be equiv to a handbook?21:28:46
@anderson_torres:matrix.orgAnderson Torreshum, I feel it lacks something like The FreeBSD Handbook.21:30:49
@fractivore:cyberia.club@fractivore:cyberia.clubI burnt out quickly on the diagramming thing, but I would still like to help with documentation as I have energy. Are the doc team meetings open to everyone?23:17:11
6 Apr 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @fractivore:cyberia.club
I burnt out quickly on the diagramming thing, but I would still like to help with documentation as I have energy. Are the doc team meetings open to everyone?
Absolutely, feel free to join any time
01:18:16
@janejasperous:nadanix.comJane JasperousDiataxis documentation framework put some light into the Manual vs Tutorial thing16:58:55
@janejasperous:nadanix.comJane Jasperous * Diataxis documentation framework put some light into the How-to Guides vs Tutorial thing16:59:20
@janejasperous:nadanix.comJane Jasperoushttps://diataxis.fr/tutorials-how-to/16:59:28
7 Apr 2024
@arilebedey:matrix.orgarilebedey joined the room.04:51:21
@fractivore:cyberia.club@fractivore:cyberia.club changed their display name from symys to symyƨ.07:58:04
@fractivore:cyberia.club@fractivore:cyberia.club changed their display name from symyƨ to sγmγƨ.08:00:52
@fractivore:cyberia.club@fractivore:cyberia.club changed their display name from sγmγƨ to SYMYƧ.08:08:31
@efun:matrix.orgefun joined the room.21:58:06

Show newer messages


Back to Room ListRoom Version: 6