Nix Documentation | 414 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 83 Servers |
| Sender | Message | Time |
|---|---|---|
| 12 Oct 2023 | ||
| I want to share my POC with the documentation team: https://hsjobeki.github.io/nix-doc-comments/reference/lib/debug/lib-debug-runtests/ Fully automated reference manual for the whole api surface of nix. In my vision this could replace: https://nix.dev/reference If you are interested into implementation details; it requires the rfc-145 and migrated-comments (according to the rfc) in nixpkgs. | 10:47:14 | |
| * I want to share my POC with the documentation team: https://hsjobeki.github.io/nix-doc-comments/reference/lib/debug/lib-debug-runtests/ Fully automated reference manual for the whole api surface of nix. In my vision this could replace: https://nix.dev/reference If you are interested into implementation details; it requires the rfc-145 and migrated-comments (according to the rfc) in nixpkgs. (This is still a POC) | 10:48:47 | |
| * I want to share my POC with the documentation team: https://hsjobeki.github.io/nix-doc-comments/reference/lib/debug/lib-debug-runtests/ Fully automated reference manual for the whole api surface of nix. In my vision this could replace: https://nix.dev/reference If you are interested into implementation details; it requires the rfc-145 and migrated-comments (according to the rfc) in nixpkgs. (This is still a POC so expect bugs and beeing incomplete) | 10:55:05 | |
In reply to @asymmetric:matrix.dapp.org.ukNo one currently working on it actively. Would be awesome if you could take that on. | 12:44:28 | |
In reply to @johannes.kirschbauer:scs.ems.hostThis looks great. Still, as @roberth suggested elsewhere recently, we should not encourage using builtins to keep separation of concerns. I suggest rendering what you have to the Nixpkgs manual. It would also avoid getting into hairy consistency problems between Nix and Nixpkgs documentation. The nix.dev reference section should ideally consist only of links to the manuals, but some things are currently hard to do in an ideal way. | 12:51:08 | |
In reply to @fricklerhandwerk:matrix.orgI can do a round of review processing. Yoloing my schedule a bit | 12:52:51 | |
| as in right now | 12:53:21 | |
| I won't be able to join today. Let me know if I need to something else regarding PR 515 | 13:10:24 | |
| Me neither, sorry for the short notice | 13:28:25 | |
| * I won't be able to join today. Let me know if I need to do something else regarding PR 515 | 13:52:45 | |
| FYI: MEME about NixOS docs 😬 https://mstdn.social/@runarcn/111215892873933877 | 16:46:09 | |
| oof | 18:18:34 | |
| 13 Oct 2023 | ||
| FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format See:
| 14:49:15 | |
| * FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format See:
| 14:49:21 | |
| * FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format See: | 14:49:30 | |
| * FWIW, what I don't like about this format is that it is incompatible with Git's tree-ish format See: | 19:24:16 | |
| 14 Oct 2023 | ||
| 08:54:15 | ||
| i've been mentioned directly here, not sure why, but anyway: as the docs team, do we have anything to say in this regard? Or can I go ahead and say "No blockers from the doc team"? I think it's a no-brainer but wanted to check with someone else first | 12:46:54 | |
| oh i see why: https://github.com/NixOS/nixpkgs/tree/1af277b55ed1fd600bc917233c83c51d06e14b8f/maintainers/team-list.nix#L252 | 12:50:06 | |
| two questions:
| 12:51:16 | |
ok 2. makes sense after reading this, although it seems to me it should default to true | 13:26:04 | |
| 15 Oct 2023 | ||
| Hi all, here I am back asking for help. :) | 07:41:06 | |
| I've managed to build my software, and if I want I can run it directly from result/bin directory. | 07:41:43 | |
| I've added a installPhase: installPhase = '' mkdir -p $out/bin cp $out/comictagger $/out/bin ''; | 07:42:38 | |
| It gives me an error: | 07:42:51 | |
| cp: cannot stat '/nix/store/mk60dlmvk66lwylm6kcs6r0kpzf9ikgd-comictagger/comictagger': No such file or directory | 07:43:19 | |
| as a matter of fact, when I ls the path, there is no executable there... What am I missing? | 07:44:29 | |
Als Antwort auf @fricklerhandwerk:matrix.orgThanks. I think reference documentation must be complete first. Then wie can add opinionated help/practices like: „dont use Builtins in nixpkgs because…“ Not having the documentation in one place is not enjoyable for most users. Most of the time you just need to get it work first then you learn about how to do it the (maybe opinionated) right way. | 07:45:39 | |
| hey there! Note that this channel is not a general help channel, unless it's about the documentation itself | 07:46:34 | |
| Sorry, I've just noticed I am writing on the wrong channel. | 07:46:48 | |