6 Nov 2024 |
Soenke Klinger | fricklerhandwerk: Could you coordinate the discussion about documentation release notes here with getpsyched? | 18:44:49 |
fricklerhandwerk | In reply to @soenkeklinger:matrix.org fricklerhandwerk: Could you coordinate the discussion about documentation release notes here with getpsyched? Sure, what exactly is it about? | 18:45:46 |
Soenke Klinger | NixOS 24.11 release notes. Its a good idea to describe what happened regarding documentation. (In wiki channel, we write about the wiki part). Release notes are a good place include some relevant information about the ecosystem and not only about package-version-upgrades.. | 18:48:32 |
getpsyched | Let's get on the same page about a few non-variables (mostly reiterating from the conversation we had),
These release notes will be in the highlights section 2-3 sentences per release note (and how many of those?) Same goes for the other documentation (non-wiki) release notes | 18:53:31 |
getpsyched | As discussed, we won't keep a criteria for the content itself, and that can be decided internally by both teams | 18:54:21 |
getpsyched | Let's get on the same page about a few non-variables (mostly reiterating from the conversation we had),
These release notes will be in the highlights section 2-3 sentences per release note (and how many of those?) Same goes for the wiki's release notes | 18:56:54 |
| getchoo joined the room. | 21:26:55 |
getchoo | In reply to @pyrox:pyrox.dev whoa getchoo reference š¤Æ š | 21:27:16 |
dish [Fox/It/She] | In reply to @getchoo:matrix.org š šļø | 21:40:36 |
13 Nov 2024 |
| inayet joined the room. | 22:16:45 |
19 Nov 2024 |
| LEGOĀ® Wormā¢ changed their display name from Federico DamiĆ”n Schonborn to LEGOĀ® Wormā¢. | 01:06:27 |
20 Nov 2024 |
| inayet removed their profile picture. | 00:59:35 |
| adamcstephens joined the room. | 16:53:28 |
adamcstephens | Hi friends. I noticed in the nixpkgs manual that all the trivial builder examples are collapsed, but the code blocks showing equivalents are not. This makes for a slightly confusing presentation. https://nixos.org/manual/nixpkgs/unstable/#trivial-builder-writeText | 16:55:26 |
fricklerhandwerk | In reply to @adam:robins.wtf Hi friends. I noticed in the nixpkgs manual that all the trivial builder examples are collapsed, but the code blocks showing equivalents are not. This makes for a slightly confusing presentation. https://nixos.org/manual/nixpkgs/unstable/#trivial-builder-writeText Iām not even sure why examples are collapsed to begin with. Hard to find anything that way. Iād be in favor of changing it | 16:57:35 |
adamcstephens | If anything I'd rather the equivalent be collapsed and the example visible by default :) | 16:58:05 |
fricklerhandwerk | Iāll gladly merge PRs! | 17:14:13 |
adamcstephens | when i find some time i'll try and figure out how to do so, unless someone can point me in the right direction :) | 18:00:53 |
fricklerhandwerk | Iād take a look at the websiteās HTML and then search for css files in doc to see where itās styled.
If examples are in Iād also search for that inside the nixos-render-docs source (lives in some subdir in Nixpkgs) | 18:07:45 |
fricklerhandwerk | * Iād take a look at the websiteās HTML and then search for css files in doc to see where itās styled.āØIf examples are in<details> Iād also search for that inside the nixos-render-docs source (lives in some subdir in Nixpkgs) | 18:08:10 |
fricklerhandwerk | Essentially try to trace back the output to the various sources and then twiddle the knobs. Thereās a devmode command in the shell inside doc that will show live updates | 18:09:18 |
21 Nov 2024 |
| Jason Odoom changed their profile picture. | 02:51:49 |
22 Nov 2024 |
| Morgan (@numinit) joined the room. | 17:51:57 |
25 Nov 2024 |
| NullCube joined the room. | 10:06:22 |
tea | A few months ago people were working on paginating the manual. How is that going? | 10:29:48 |
29 Nov 2024 |
fricklerhandwerk | In reply to @noob_tea:matrix.org A few months ago people were working on paginating the manual. How is that going? People is getpsyched with some eyeballs from me. It's still going and deeply in the weeds with preliminary work. You can follow progress in the work log.
I'm not sure it will fully snap together by the end of the timeline mid December, but the most important parts of making a page split possible without disrupting workflows will fairly certainly get done.
| 00:35:17 |
tea | In reply to @fricklerhandwerk:matrix.org
People is getpsyched with some eyeballs from me. It's still going and deeply in the weeds with preliminary work. You can follow progress in the work log.
I'm not sure it will fully snap together by the end of the timeline mid December, but the most important parts of making a page split possible without disrupting workflows will fairly certainly get done.
wow, that is very detailed | 08:42:44 |
tea | thanks! | 08:42:49 |
| misuzu joined the room. | 17:39:49 |
misuzu | Hi! I've stumbled on https://github.com/NixOS/nixpkgs/actions/runs/12071127791/job/33662163276?pr=341598 and I don't really understand what must be done in this new module for the NixOS manual to build properly. Is there some kind of documentation for how to properly add these redirects for modules documentation? | 17:44:32 |