| 3 Jul 2023 |
pennae | the homepage runs xslt over manual xhtml, which is going to ... Great ๐ | 17:22:39 |
ncfavier | In reply to @pennae:matrix.eno.space eg, does nixos-search use docbook/xhtml? i don't think so | 17:37:04 |
pennae | that's good already :) | 17:38:14 |
ncfavier | we just render (previously docbook/) markdown snippets to html with pandoc. btw, it would be nice if we could use nixos-render-docs to do that | 17:38:18 |
ncfavier | that way we don't need to keep link-manpages.nix around | 17:38:39 |
pennae | that pretty much just needs a new options render mode that returns a collection of fragments instead of a document, shouldn't be that much work | 17:39:14 |
pennae | the infra needed to do that is there and used internally to speed up options rendering, it pretty much only needs exported as a mode | 17:39:48 |
pennae | would still like to remove link-manpages.nix from nixpkgs soon, or rather: get that pr merged so it can't diverge and need rework | 17:44:42 |
| Nate joined the room. | 18:02:38 |
ncfavier | on it | 18:11:17 |
pennae | awesome ๐ | 18:12:58 |
pennae | thanks! | 18:48:38 |
pennae | and now docbook is no longer ๐ | 18:48:50 |
Jan Tojnar | great job | 19:01:04 |
pennae | there's a lot of issues that can be closed now | 19:03:26 |
| 4 Jul 2023 |
asymmetric | so has the markdown manual been deployed to nixos.org? | 09:01:20 |
asymmetric | or when will that happen? | 09:01:34 |
asymmetric | https://nixpk.gs/pr-tracker.html?pr=239636 | 09:01:35 |
pennae | not deployed yet in any case, you'd notice by `...` in lib docs turning into inline code blocks | 09:29:56 |
| 5 Jul 2023 |
pennae | In reply to @asymmetric:matrix.dapp.org.uk so has the markdown manual been deployed to nixos.org? flake update that pulls the manual changes happens on sunday, or whenever someone triggers the necessary workflow
(not going to try) | 00:01:12 |
asymmetric | In reply to @pennae:matrix.eno.space flake update that pulls the manual changes happens on sunday, or whenever someone triggers the necessary workflow
(not going to try) It looks like that action only updated nixpkgs, which is not used for the manual | 09:43:34 |
asymmetric | In reply to @pennae:matrix.eno.space flake update that pulls the manual changes happens on sunday, or whenever someone triggers the necessary workflow
(not going to try) * It looks like that action only updates nixpkgs, which is not used for the manual | 09:43:43 |
asymmetric | https://github.com/NixOS/nixos-homepage/blob/87127a734b9789c222d404e4515a498a31c69edc/.github/workflows/update-flake-lock.yml#L23C4-L23C4 | 09:43:51 |
asymmetric | https://github.com/NixOS/nixos-homepage/blob/87127a734b9789c222d404e4515a498a31c69edc/flake.nix#L8C1-L8C1 | 09:44:23 |
pennae | In reply to @asymmetric:matrix.dapp.org.uk It looks like that action only updates nixpkgs, which is not used for the manual ah, missed that. | 12:56:40 |
pennae | looks like the hourly update takes care of those, and finally picked up the md manual and deployed it | 12:57:03 |
| wamirez joined the room. | 23:32:55 |
wamirez | Hello NixOS documentation team,
this is Daniel and I wanted to introduce myself to you all as briefly as possible to not break the flow of your conversation. The reason for my showing up out of the blue is that I'd like to become more familiar with the Nix environment/community, with the goal of landing a spot in one of next year's Summer of Nix mobs as a participant.
I've been catching up here and there with "new" paradigms and tools like functional programming, lambda calculus, and Haskell, after many years of procedural programming being beaten into my head by university courses and then of me doubling down on it on my own. I chose to study the closest thing to my hobby (mountaineering) that my home university had to offer, which at the time was geological engineering, only to find out later that a hobby is usually just that: a hobby. Nevertheless, I'd like to think that I have a good framework for tackling problems, and also good language skills that can be of use to contribute to documentation projects you may have or need help with :).
On a superficial level, and to get me started, I thought I could process some of the Nix Hour recordings and come up with news articles based on them to make myself acquainted with the jargon and the ecosystem before working on Nix.dev's open issues and/or pull requests. Of course, I'm open to any suggestions or roadmaps you may already have in place.
Cheers from the Venezuelan Andes,
Daniel Ramรญrez | 23:41:36 |
| wamirez set a profile picture. | 23:48:25 |
| 6 Jul 2023 |
@mightyiam:matrix.org | Welcome | 00:02:21 |