| 8 Aug 2022 |
 John Ericson | the other documentation quadrants handle brevity and clarity | 12:25:40 |
| John Ericson | Of course, this is an argument for just folding the abstract stuff in the concrete sections too, because | 12:26:07 |
| John Ericson | * Of course, this is an argument for just folding the abstract stuff in the concrete sections too :) because there is no hard reason it can't just be longer sections with more information in a reference | 12:26:42 |
| John Ericson |
but it will not be helpful for the vast majority of software developers who just want do get their job done - our targeted audience!
| 12:27:19 |
| John Ericson | *
but it will not be helpful for the vast majority of software developers who just want do get their job done - our targeted audience!
The target audience a reference for me is people who don't just care about getting a job done, but want to understand it more completely
| 12:27:44 |
| John Ericson |
I agree that there is a meta-topic about content-addressing, immutability, and theory of computaton, but I deem it very much out of scope for Nix documentation.
It's not supposed to be a theory of things in general, it is supposed to be a theory of just Nix. I can fold together every abstract--concrete pair, but I do need to say what all the various types of store objects, drvs, etc. have in common at some point
| 12:29:01 |
| John Ericson | Anyways I am first going to try to finish the concrete spec info | 13:12:58 |
| John Ericson | but then I will try to make the abstract part less philosphical | 13:13:16 |
| 9 Aug 2022 |
 tpw_rules | https://github.com/NixOS/nix/issues/6623 | 02:13:29 |
| tpw_rules | * is there an alternate branch or something with the new nix documentation rendered? | 02:13:44 |
| tpw_rules | i saw it was commented out from the official docs shortly after it was merged | 02:13:51 |
 asymmetric | should we remove experimental commands from the stable nix manual? | 10:12:16 |
| asymmetric | e.g. https://nixos.org/manual/nix/stable/advanced-topics/post-build-hook.html?highlight=sign#implementing-the-build-hook uses nix store sign | 10:12:28 |
|  Solène Rapenne (she/her) changed their display name from Solène (she/her) to Solène Rapenne (she/her). | 15:14:25 |
|  Bryan Honof joined the room. | 15:33:02 |
|  Ken Sonoda joined the room. | 16:00:11 |
 fricklerhandwerk | In reply to @asymmetric:matrix.dapp.org.uk
should we remove experimental commands from the stable nix manual? In the documentation team so far we have consensus that, yes, we should not assume or nudge people to use what is not stable. But we also want to document flakes as good as we can, ideally to be ready in sync with a stable release. | 16:14:04 |
| Ken Sonoda set a profile picture. | 16:24:10 |
| 10 Aug 2022 |
|  Flávio Martins Prado joined the room. | 05:45:16 |
| Flávio Martins Prado | Hi, just noted that the link to matrix on the manual preface is broken | 05:45:54 |
| Flávio Martins Prado | should a report be open or one just correct on nixpkgs directly? | 05:46:24 |
 Winter (she/her) | Which manual? There may be an extra step to take depending on the manual. | 05:50:04 |
| Winter (she/her) | But yes, opening a PR is preferred if you want to do so :) | 05:50:20 |
| Flávio Martins Prado | is thenixos manual | 05:57:24 |
| Flávio Martins Prado | sorry nixpkgs manual | 05:58:29 |
| Flávio Martins Prado | its wrong on both actually | 06:01:51 |
| Flávio Martins Prado | ok i will open the report, there is some template for reporting on the documentation? (there is for bugs) | 06:03:41 |
| Flávio Martins Prado | dang i read gug report lol i will correct and commit the correction:) | 06:07:27 |
|  luxus joined the room. | 09:56:48 |
| luxus | fricklerhandwerk: thanks for your lecture.. i really felt stupid yesterday for not understanding. vielen danke 😄 | 10:01:54 |
