!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

383 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 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 70 Servers

Load older messages


SenderMessageTime
4 Apr 2024
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host Ah just saw infinisil already requested changes 14:09:43
@infinisil:matrix.orginfinisil danielsidhion: If you want I can give you an email invite for the doc team meetings, you can PM me an email for that 15:30:36
@pennae:matrix.eno.space@pennae:matrix.eno.space infinisil while you're at it, can you remove us from the invite list? 15:36:04
@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.org@anderson_torres:matrix.orgWhat 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.org@anderson_torres:matrix.org* What we have that would be equiv to a handbook?21:28:46
@anderson_torres:matrix.org@anderson_torres:matrix.orghum, 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

Show newer messages


Back to Room ListRoom Version: 6