!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

403 Members
Discussion about documentation improvements around the Nix ecosystem82 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
22 Mar 2024
@ibizaman:matrix.orgibizaman Awesome, I’m glad for the positive feedback! 😊 What takes me a long time usually when writing is figuring out all the ideas and how they should fit in what order. I’m hoping that time will be reduced drastically by copying another great example which served me well a bunch of times already. 14:22:21
@efx:matrix.orgEli Flanagan danielsidhion: howdy! here is that docs cleanup PR I mentioned last week but couldn't submit: https://github.com/NixOS/nixpkgs/pull/298127
Turns out, one cannot sign up for a GitHub profile using aliased emails for initial configuration. I then tried with a work email, managed by Microsoft Office 365, and it they believed I am human.
18:16:29
@danielsidhion:nixos.devdanielsidhionThank you! Glad you figured out the issue with GitHub!21:37:10
@savanni:luminescent-dreams.com@savanni:luminescent-dreams.com left the room.21:45:06
23 Mar 2024
@federicodschonborn:matrix.org@federicodschonborn:matrix.org joined the room.00:37:56
24 Mar 2024
@dmills27:matrix.orgDominic MillsHere's my first draft for the Google Season of Docs proposal: https://github.com/DMills27/Nix-Google-Season-of-Docs. I'm continuously working on it. Any criticisms/feedback is welcomed!14:35:00
@roberthensing:matrix.orgRobert Hensing (roberth) Just wrote a testers helper to check links, if you're interested: https://github.com/NixOS/nixpkgs/pull/298665 15:52:38
@dmills27:matrix.orgDominic Mills * Here's my first draft for the Google Season of Docs proposal: https://github.com/DMills27/Nix-Google-Season-of-Docs. I'm continuously working on it. Any criticisms/feedback are welcomed!17:15:34
26 Mar 2024
@cblacktech:matrix.orgcblacktech joined the room.02:02:59
28 Mar 2024
@janne.hess:helsinki-systems.de@janne.hess:helsinki-systems.de joined the room.09:13:17
@pennae:matrix.eno.space@pennae:matrix.eno.space infinisil: reminder that you said you'd review a pr that removes the deprecated docbook support bits from the manual machinery 13:45:43
@fricklerhandwerk:matrix.orgfricklerhandwerk I’ll be in today again. danielsidhion has a write up for how to proceed with the Nixpkgs manual. We also should sync on Google Season of Docs. And whatever else is going on. 14:01:00
@infinisil:matrix.orginfinisil pennae: Ah yeah thanks for the reminder, it's in my notifications backlog, just didn't get to it yet. We might be able to review/merge it in the docs team meeting today, I'll put it on the agenda :) 14:14:57
@danielsidhion:nixos.devdanielsidhion fricklerhandwerk: infinisil Dominic Mills I made after-the-fact notes for the meeting today based on what I remembered, can you check if I missed anything? https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA?edit 20:59:08
@fricklerhandwerk:matrix.orgfricklerhandwerk danielsidhion: posted 21:35:24
@pennae:matrix.eno.space@pennae:matrix.eno.space

https://ethercalc.net/dc4vcnnl8zv0
people.
danielsidhion/fricklerhandwerk.

Does it support GitHub-flavored markdown? [nrd:] If we implement it
Can we render it to multiple pages? [nrd:] If we implement it
How can someone navigate the rendered docs? [nrd:] Single-page output with only immediate children visible on each section

we are increasingly concerned that people don't fucking read what we say. gfm is supported (the manual uses gfm tables!), multipage rendering is in use right now, tocgen is configurable.

infinisil asked as to come back to answer questions regarding the tooling, we've yet to hear one. should we just fucking leave again?

22:49:06
29 Mar 2024
@sebtm:lodere.esSebTM joined the room.04:23:53
@shalokshalom:kde.org@shalokshalom:kde.org joined the room.05:59:53
@shalokshalom:kde.org@shalokshalom:kde.orgI dont find the Wiki 2 channel anymore06:01:58

Show newer messages


Back to Room ListRoom Version: 6