!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

439 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
3 Aug 2023
@sternenseemann:systemli.orgsterniI’m attending09:28:42
@asymmetric:matrix.dapp.org.ukasymmetric Posting here a couple of links I’d like to discuss in the call, as I’m on mobile 13:55:29
@asymmetric:matrix.dapp.org.ukasymmetrichttps://github.com/NixOS/rfcs/pull/46#issuecomment-164965360613:55:32
@asymmetric:matrix.dapp.org.ukasymmetrichttps://github.com/NixOS/nixpkgs/pull/245368#discussion_r127341048113:55:58
@silvio:booq.org@silvio:booq.org left the room.16:08:27
4 Aug 2023
@asymmetric:matrix.dapp.org.ukasymmetricima_0f387f3.png
Download ima_0f387f3.png
07:53:03
@asymmetric:matrix.dapp.org.ukasymmetricima_32a5d86.png
Download ima_32a5d86.png
07:53:37
@asymmetric:matrix.dapp.org.ukasymmetricIs this happening to other people as well? I sometimes get these floods of emails about our events, and it’s not clear why07:55:37
@asymmetric:matrix.dapp.org.ukasymmetricAlso, the list of participants with their email addresses is public, which I think is not necessary?07:56:05
@infinisil:matrix.orginfinisilDamn that's bad :/08:04:21
@infinisil:matrix.orginfinisilGoogle Calendar said it would only send an update to the one new email i added to the guest list 🙃08:05:35
@asymmetric:matrix.dapp.org.ukasymmetricI think hiding the guest list might help? At least that’s what another calendar admin told me09:42:27
@infinisil:matrix.orginfinisilAh that sounds like a good idea10:12:00
@nonuke:matrix.orgnonuke joined the room.20:14:42
6 Aug 2023
@spacekookie:fairydust.spacekookie changed their profile picture.16:15:31
7 Aug 2023
@i97henka:matrix.orgi97henkaHi all - I will be on summer holidays - back again in the meetings on August 24th.09:30:39
@ncfavier:matrix.orgncfavier changed their profile picture.09:41:21
@asymmetric:matrix.dapp.org.ukasymmetricWon’t make it today13:42:07
8 Aug 2023
@pennae:matrix.eno.spacepennae left the room.20:19:08
9 Aug 2023
@osslate:fsfe.orgosslate joined the room.16:01:43
@osslate:fsfe.orgosslateHi! I'm a technical writer by trade and I'd love to really help out with end-user Nix docs. For me, there's been a real problem with documentation resources accessible to people like me who are totally new to the paradigm Nix offers, and I'd like to play whatever part I can to improve them. I'm relatively skilled in docs structure, ensuring things are simple for the audience, and politely pestering people for technical info :)16:08:15
@osslate:fsfe.orgosslateWell, maybe not totally new at this stage... but new enough where things are still confusing!16:09:13
@penguincoder:matrix.wolfie.pw@penguincoder:matrix.wolfie.pwI sat in on one of the doc team's weekly meetings and they were reviewing a guide or outline for someone to come and write a longer form document.16:41:25
@penguincoder:matrix.wolfie.pw@penguincoder:matrix.wolfie.pwhttps://github.com/NixOS/nix.dev/tree/master/maintainers/working_groups/learning_journey/tutorial-outlines16:44:07
@proofconstruction:matrix.orgproofconstructionWelcome! If you can make it to the docs team meeting tomorrow, we could always use extra help! Here's the calendar: https://calendar.google.com/calendar/u/0/embed?src=b9o52fobqjak8oq8lfkhg3t0qg@group.calendar.google.com&pli=116:58:39
@osslate:fsfe.orgosslateSweet! I'll take a look at this tomorrow17:58:34
@osslate:fsfe.orgosslateFantastic :) looks like a good time for me, I'll be there!17:59:22
10 Aug 2023
@osslate:fsfe.orgosslateis nix.dev versioned somehow, to correspond with nixos/nixpkgs channels?11:10:50
@osslate:fsfe.orgosslateThis was a consideration I had in writing my own books/docs. Antora seemed like the best toolchain to achieve proper versioning and a toggle to switch, but I decided against it for my personal project as parsing Asciidoc to write automated codeblock testing infra is a pain11:13:15
@osslate:fsfe.orgosslateexample: Fedora documentation (Antora based) with a version toggle on the bottom left: https://docs.fedoraproject.org/en-US/fedora/latest/ There appears to be some Sphinx plugins laying around that do something similar, though I haven't tried them myself11:20:54

Show newer messages


Back to Room ListRoom Version: 6