| 6 Aug 2023 |
|  kookie changed their profile picture. | 16:15:31 |
| 7 Aug 2023 |
 i97henka | Hi all - I will be on summer holidays - back again in the meetings on August 24th. | 09:30:39 |
|  ncfavier changed their profile picture. | 09:41:21 |
 asymmetric | Won’t make it today | 13:42:07 |
| 8 Aug 2023 |
|  pennae left the room. | 20:19:08 |
| 9 Aug 2023 |
|  osslate joined the room. | 16:01:43 |
| osslate | Hi! 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 | Well, maybe not totally new at this stage... but new enough where things are still confusing! | 16:09:13 |
 @penguincoder:matrix.wolfie.pw | I 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 | https://github.com/NixOS/nix.dev/tree/master/maintainers/working_groups/learning_journey/tutorial-outlines | 16:44:07 |
 proofconstruction | Welcome! 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=1 | 16:58:39 |
| osslate | Sweet! I'll take a look at this tomorrow | 17:58:34 |
| osslate | Fantastic :) looks like a good time for me, I'll be there! | 17:59:22 |
| 10 Aug 2023 |
| osslate | is nix.dev versioned somehow, to correspond with nixos/nixpkgs channels? | 11:10:50 |
| osslate | This 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 pain | 11:13:15 |
| osslate | example: 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 myself | 11:20:54 |
 infinisil | osslate: It is not, but I'd be in favor of having that, though because nix.dev can contain content relating to both Nix, Nixpkgs and possibly more, it should maybe somehow expose the versions of all of these orthogonally | 11:22:21 |
| infinisil | Not sure how that should work though, haven't given it a lot of thought | 11:22:31 |
| osslate | Hmmm that's true. It could get messy without proper thought | 11:23:20 |
