3 Jul 2021 |
ryantm | Jan Tojnar probably but why? | 13:10:52 |
Jan Tojnar | I am still not very happy about keeping generated code in the repo 🤷♀️ | 13:12:39 |
5 Jul 2021 |
| spacesbot - keeps a log of public NixOS channels joined the room. | 19:20:30 |
| spacesbot - keeps a log of public NixOS channels | 19:49:29 |
| ncfavier changed their profile picture. | 23:32:32 |
6 Jul 2021 |
| spacesbot - keeps a log of public NixOS channels changed their display name from spacesbot to spacesbot - keeps a log of public NixOS channels. | 22:11:45 |
8 Jul 2021 |
Jan Tojnar | ryantm: another benefit would be converting option descriptions to markdown | 16:22:51 |
Jan Tojnar | which would help https://github.com/NixOS/nixos-search/issues/303 | 16:23:03 |
| multivariante joined the room. | 22:20:47 |
| multivariante left the room. | 22:21:13 |
12 Jul 2021 |
Jan Tojnar | ryantm: I like that the link name and target is decoupled | 22:49:42 |
Jan Tojnar | also I needed some syntax to use for docbook-to-markdown conversion | 22:50:25 |
Jan Tojnar | and currently, MyST looks like the only contender for the docs anyway https://github.com/NixOS/nixpkgs/pull/105036 | 22:50:58 |
Jan Tojnar | * ryantm: I like that the link name and target is decoupled, especially for option documentation | 22:53:35 |
ryantm | Jan Tojnar: link name and target can already be decoupled in basic CommonMark on the per-document level. | 23:08:58 |
Jan Tojnar | I meant for the option documentation | 23:09:32 |
Jan Tojnar | it will also allow us to swap the links locally (in the produced manpage) | 23:10:21 |
ryantm | Jan Tojnar: What's stopping mmdoc from being a contender for you? | 23:28:24 |
Jan Tojnar | ryantm: I though it was mostly meant as temporary demo | 23:29:07 |
ryantm | Jan Tojnar: I made it because the NixOS manual needs a small closure-size renderer. I was hoping it could be made be good enough for all the manuals though, for consistency sake. | 23:30:27 |
ryantm | I also like how fast it is. It should be pretty easy to set up some live-reload kind of thing. | 23:31:49 |
Jan Tojnar | then there is the issue with extensibility – it is basically impossible to do anything more interesting without forking cmark-gfm | 23:35:55 |
Jan Tojnar | and the other C library I found (lowmark) is extensible but basically frozen | 23:36:56 |
ryantm | Maybe we do not need too much extensibility. The more we extend it, the more complicated it is for authors to use. I think that is part of the point of moving away from DocBook. | 23:38:11 |
Jan Tojnar | yeah, but the RFC also agreed that the plain CommonMark is too little | 23:41:35 |
Jan Tojnar | and even basic stuff like admonitions is currently super hacky | 23:42:12 |
Jan Tojnar | if we want to maintain our own solution, it should be at least easy, IMO | 23:44:15 |
ryantm | Fair enough. I did throw together the extensions I added very quickly. | 23:46:33 |
ryantm | I'm planning to keep working on mmdoc, and I have some time over the next couple weeks, so hopefully I can improve it a bunch. | 23:48:00 |
Jan Tojnar | you did good job, the API will not allow you do much better | 23:48:47 |