| 6 Nov 2024 |
soenke | @getpsyched:matrix.org: thought about contacting,you. Its good, meybe we need,two discussions. Here about the Documentation ecosytem and manuals. And in the wiki channel about the wiki content? | 13:09:38 |
getpsyched | Absolutely. | 13:11:46 |
getpsyched | I'll get getchoo to join, so we can get things moving quickly | 13:13:53 |
| seapat joined the room. | 13:50:48 |
dish [Fox/It/She] | whoa getchoo reference 𤯠| 15:21:16 |
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 |
| @federicodschonborn:matrix.org 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 |
| @adam:robins.wtf joined the room. | 16:53:28 |
@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 | 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 |
@adam:robins.wtf | 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 |
@adam:robins.wtf | 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 |
| @nerves:bark.lgbt changed their profile picture. | 02:51:49 |
| 22 Nov 2024 |
| Morgan (@numinit) joined the room. | 17:51:57 |
| 25 Nov 2024 |
| @nullcube:matrix.org 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 |