| 7 Nov 2023 |
 infinisil | In reply to @asymmetric:matrix.dapp.org.uk
as future work or as out of scope? I don't think there's an out of scope section. Future work sounds good | 10:56:06 |
| 8 Nov 2023 |
 fricklerhandwerk | https://discourse.nixos.org/t/a-portable-nix-shell-shebang/35148/2
What do you think? If we want this, anyone interested in seeing it through? | 00:26:48 |
| fricklerhandwerk | * https://discourse.nixos.org/t/a-portable-nix-shell-shebang/35148/2
What do you think? đđ? If we want this, anyone interested in seeing it through? | 00:27:31 |
| infinisil | It's a bit non-standard, but it seems fine | 02:27:59 |
| fricklerhandwerk | In reply to @infinisil:matrix.org
It's a bit non-standard, but it seems fine We could iterate on it | 07:38:23 |
| 9 Nov 2023 |
 raboof | do we have any doc writing guidelines such as "try to avoid words like 'simply'"? | 09:10:41 |
| fricklerhandwerk | In reply to @raboof:matrix.org
do we have any doc writing guidelines such as "try to avoid words like 'simply'"? Whe have a style guide for nix.dev https://nix.dev/contributing/documentation/style-guide
but no specific note on âsimplyâ. | 09:33:34 |
 asymmetric | In reply to @raboof:matrix.org
do we have any doc writing guidelines such as "try to avoid words like 'simply'"? what's your beef with "simply"? đ | 09:50:15 |
| raboof | in short, documentation is almost always better without it: it is typically added to encourage the reader, but often has the opposite effect and may even appear condescending, especially when the reader runs into trouble trying to apply the suggestions from the documentation. Best-case it's mostly just noise. I'm sure others have motivated this better than I can in a few sentences though, I can see if I can dig up any good references later - first wanted to see if we had any already. | 09:55:08 |
| fricklerhandwerk | In short: whatâs simple for you may be impossible for others. Avoiding that is in line with our stance not to assume things about the reader | 10:03:08 |
| fricklerhandwerk | * In short: whatâs simple for you may be impossible for others. Avoiding that is in line with our stance not to assume things about the reader and not making value judgements | 10:03:38 |
| fricklerhandwerk | Thatâs why for instance in reviews I always suggest alternatives to âas you can seeâŚâ or âyou will see an outputâŚâ â no, not everyone can see. | 10:05:55 |
| fricklerhandwerk | There are entire software companies full of people who canât see. | 10:07:28 |
| asymmetric | My pet peeve is "trivial" đ | 10:45:38 |
| fricklerhandwerk | âLeft as an exercise for the readerâ | 11:20:52 |
