| 31 Jul 2023 |
 pennae | 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 | 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 | 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 | 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 | currently there's nothing pressing since nixos-render-docs has kind of become the renderer for nixpkgs/nixos 😶 | 20:05:09 |
| pennae | 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 | 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 |
| asymmetric | https://github.com/NixOS/nixpkgs/pull/245368#discussion_r1273410481 | 13:55:58 |
