| 5 Aug 2022 |
|  Kira Bruneau joined the room. | 01:24:48 |
| Kira Bruneau changed their display name from daxvena to Kira Bruneau. | 01:24:52 |
| 6 Aug 2022 |
 John Ericson | FYI to all, fricklerhandwerk's and I's reference (and some explanation docs were merged but commented out), and then I fixed up some conflicts and added more new material on my branch, opening https://github.com/NixOS/nix/pull/6877/files | 03:39:40 |
| John Ericson | I am curious what people think about this split format I went with, also perhaps of commenting out the material we can do some sort of build time flag to show/hide unstable docs | 03:41:01 |
| John Ericson | I do want users to see the new docs, but I also on fond of just brain dumping all the information and then stepping back to edit it into the right format | 03:41:52 |
 olaf | In reply to @Ericson2314:matrix.org
I am curious what people think about this split format I went with, also perhaps of commenting out the material we can do some sort of build time flag to show/hide unstable docs "split format" means 1 sencence per line? yes i think that was fricklerhandwerk suggestion before and i think it is best for collaboratively written documentation.
Commented out "braindumps" are ok i think but there should be additional information so that these comments can also be removed if they are abandoned, information like "[2022.08.01 PR in preparation]" . | 15:23:39 |
| John Ericson | denna: oh the spit format I mean abstract vs concrete | 15:24:04 |
| John Ericson | I introduce a sort of "platonic nix" | 15:24:11 |
| John Ericson | and then I get into the gory details of files, the exact way we hash store objects, etc. | 15:24:26 |
| John Ericson | * and then I get into the gory details of files directories symlinks, the exact way we hash store objects and render store paths, etc. | 15:24:45 |
| olaf | as a initial comment. i am suspicious of the suggestion to use pseudo code but need to render it to see how it feels. | 16:05:47 |
 tpw_rules | maybe it's me, but i'm not sure i like starting out the docs even farther away from actual nix | 16:30:52 |
| tpw_rules | oh i see there is commentary on this in the issue | 16:32:19 |
|  yuu changed their display name from yuu to YourNick. | 17:41:38 |
| yuu changed their display name from YourNick to yuu[m]. | 17:42:23 |
| John Ericson | denna: I am fine if the pseuco code data structures become diagrams some how | 17:58:33 |
| John Ericson | tpw_rules: FWIW my long term hope is that if Nix starts supporting things like WASI/WASM and whatever else, the abstract model will become more than idea in our heads, but also what ties everything together | 17:59:21 |
| John Ericson | I created new types of content addressing for the IPFS stuff for example (an option for "deep content addressing, were references are not arbitrary store paths but something more structured that prooves it is content addressed all the way down) | 18:00:26 |
| John Ericson | One could just document every instance of the general idea, but one is left then with a big bag of special cases with the underlying theme left as an exercise to the reader | 18:01:19 |
| tpw_rules | but regular content addressing isn't even a common thing yet. i feel like 90% of nix users and initial observers want to know about package management | 18:02:12 |
| John Ericson | regular content addressing of store objects is common | 18:02:34 |
| John Ericson | that is how all source code wroks | 18:02:39 |
| John Ericson | * that is how all source code works | 18:02:42 |
| John Ericson | more broadly I am trying to write the reference | 18:02:53 |
| John Ericson | which includes all the things without deciding what is more important or not | 18:03:05 |
| John Ericson | then separately people can debate what the right practical guides (top half of the documentation quadrant) should be | 18:03:45 |
| John Ericson | but trying to write curated guides were the underlying info is just recalled from memory (no reference to fall back on) feel to me like quite difficult | 18:04:39 |
| tpw_rules | okay, that makes sense | 18:04:54 |
| John Ericson | :) | 18:05:03 |
| tpw_rules | might be rushing things in my head a bit | 18:05:05 |
