sgf-render VS lemmy-help

a CLI tool for rendering Go (the board game) records,

As an example, here's the CI config I use for building a hobby project of mine for Linux/Mac/Windows.

I've just realized that the way --kifu currently works id doesn't pay attention to --first-move-number so this will be a little funky. I've opened an issue to fix that. I'll probably get to it in the next week or so (if I don't find time today).

Thanks! In case anyone is curious, the tool I used is available here: https://github.com/julianandrews/sgf-render.

Huh! I actually wrote a utility to render diagrams (https://github.com/julianandrews/sgf-render) and looking around a bunch all the diagrams I saw skipped 'I' so I did the same.

Here's the repo: https://github.com/julianandrews/sgf-render

So let me tell you about my experience! In the stone ages of lua plugins, I was maintaining a markdown file to note down all the APIs but as the plugin was constantly changing, docs were getting out of sync very quickly and it was a royal pain to update them. So, in my case emmylua was the obvious choice for the docs, so I began searching for tools that convert emmylua to vim-help, luckily I found tree-sitter-lua#docgen and mini.doc. But in the end, I decided to write my own tool, and thus lemmy-help was born. Here a help file generated by it

When I added some EmmyLua docs to one of my plugins (to generate Vimdoc using lemmy-help), I noticed lua-language-server was giving me diagnostics based on my documentation. This was something I was not getting from linters like luacheck. So I asked myself, "Can I leverage lua-language-server and EmmyLua to statically type check my Lua code?"

This will drastically improve the UX of help files. I am adding support for this in lemmy-help here https://github.com/numToStr/lemmy-help/pull/65 and I hope other doc generators can leverage this to provide beautiful help docs :)

If you want to provide vim doc, I recommend to use lemmy-help as soon as possible.

Rust is great for parsing text. I created https://github.com/numToStr/lemmy-help to parse emmylua from lua code and convert it into vim help doc. I am also reading https://craftinginterpreters.com/ to expand my parsing knowledge and using Rust as the implementation language.

I just released lemmy-help v0.8.0 which now has support for all* emmylua types. That means you can use any complex types in you emmylua annotations and it will be parsed correctly and vimdoc will be rendered as expected

And if you are writing lua plugin which have public API, I would recommend writing emmylua and covert that into vimdoc using https://github.com/numToStr/lemmy-help (Self Plug)

multiline ---@field description

I've just released https://github.com/numToStr/lemmy-help :)

That's just too much. You can just download the binaries from the releases page https://github.com/numToStr/lemmy-help/releases