| 31 Jul 2023 |
 henrik-ch | What I have seen and been impressed by is https://ryantm.github.io/nixpkgs/ and I took a look to see how it's been rendered, that's all. I am still very much a beginner to all these things. | 15:50:22 |
 @pennae:matrix.eno.space | we're just a little confused by the generic "alternative manual rendering" juxtaposed with a "nixpkgs" url. nixos-render-docs is itself an alternative/replacement of mmdoc because mmdoc is such a nightmare to extend | 15:50:58 |
| henrik-ch | In reply to @pennae:matrix.eno.space
we're just a little confused by the generic "alternative manual rendering" juxtaposed with a "nixpkgs" url. nixos-render-docs is itself an alternative/replacement of mmdoc because mmdoc is such a nightmare to extend You clearly know a lot more about this topic than I do! I am sorry if the statements caused confusion or concern. | 15:52:04 |
| @pennae:matrix.eno.space | we're happy to explain if you have any questions | 15:53:39 |
 ryantm | What is "such a nightmare to extend" based upon? | 17:34:54 |
| ryantm | Is merely using C as the implementation language enough to brand it as such? | 17:35:27 |
| @pennae:matrix.eno.space | personal experience; we tried to add an extension (forget which one it was, unfortunately) and just gave up after a while because it kept segfaulting and misbehaving in other ways :/ | 17:55:23 |
| @pennae:matrix.eno.space | you did an amazing job getting it as far as it is, but that experience and the many pitfalls of complex software written in C have us worry that it won't be very maintainable by anyone except you | 17:57:08 |
| ryantm | Alright, well I'm still actively working on improving it, so if you have feature requests I'd be interested in hearing them. | 20:03:12 |
| @pennae:matrix.eno.space | currently there's nothing pressing since nixos-render-docs has kind of become the renderer for nixpkgs/nixos 😶 | 20:05:09 |
| @pennae:matrix.eno.space | we're not attached to the tool at all, if you can do better with mmdoc then by all means go for it | 20:07:13 |
| @pennae:matrix.eno.space | but maintainability is a concern we have, and python does tend to be easier on contributors than C | 20:08:11 |
| 1 Aug 2023 |
|  Charles changed their profile picture. | 01:12:22 |
 fricklerhandwerk | In reply to @pennae:matrix.eno.space
but maintainability is a concern we have, and python does tend to be easier on contributors than C I second that. From everyone I read of or talked to about documentation (I’m mainly in touch with a bunch of Haskellers) I got convinced we should put extraordinary emphasis on low tech tooling, meaning they should be easily accessible to the average user. Python ans Markdown fit the bill better than, say, C and ReST | 08:33:21 |
 RÃgille S. B. Menezes | Hey I'm new here, just wanted to share this because I think giving more emphasis on this tip would be a good idea in the documentation
https://twitter.com/sullyj3/status/1686231703445221377 | 13:29:32 |
 asymmetric | In reply to @rigille:matrix.org
Hey I'm new here, just wanted to share this because I think giving more emphasis on this tip would be a good idea in the documentation
https://twitter.com/sullyj3/status/1686231703445221377 hey, welcome! That command is marked as experimental, and as such it is currently out of scope for nix.dev | 13:34:05 |
| RÃgille S. B. Menezes | Oh I see | 13:36:50 |
| 2 Aug 2023 |
 infinisil | This is still a draft PR and not done, but it could already use some feedback, best reviewed commit-by-commit, with most commits just moving things around, only some add new content: https://github.com/NixOS/nixpkgs/pull/245243 | 22:41:38 |
| infinisil | I'd also like to discuss it briefly in this Thursday's docs team meeting | 22:42:17 |
|  @adam:robins.wtf joined the room. | 23:41:48 |
|  @adam:valkor.net left the room. | 23:41:52 |
| 3 Aug 2023 |
| asymmetric | I 90% won’t make it to todays doc-comments RFC meeting unfortunately cc Johannes Kirschbauer @hsjobeki | 09:21:58 |
| asymmetric | Would be cool to have a room to discuss, should it be here, or maybe a specific one for the rfc? | 09:22:34 |
| asymmetric | Also, only 2 shepherds had ack’d today’s meeting | 09:24:26 |
| asymmetric | * I 90% won’t make it to todays doc-comments RFC meeting unfortunately cc Johannes Kirschbauer @hsjobeki | 09:24:58 |
| asymmetric | In reply to @asymmetric:matrix.dapp.org.uk
Would be cool to have a room to discuss, should it be here, or maybe a specific one for the rfc? I’d prefer a separate one, but I don’t know who can create it on nixos.org | 09:25:38 |
| asymmetric | cc sterni | 09:27:53 |
 sterni | I’m attending | 09:28:42 |
| asymmetric | Posting here a couple of links I’d like to discuss in the call, as I’m on mobile | 13:55:29 |
| asymmetric | https://github.com/NixOS/rfcs/pull/46#issuecomment-1649653606 | 13:55:32 |
