Hi there,
I have been working on this library for rescript react components, wanted to have a proper and low-maintenance documentation for these components. So I have created a doc-generator tool, this uses rescript-tools underneath to extract MDX from @ocaml.doc macro. I have used a custom components for displaying these MDX components which is completely pluggable with different other components, its all experimentation.
After trying out multiple different ways, I came to an arrangement where visual display of components behaviour can be written in React (so reusing intelliesense which we already have on editor) and this tool will pick those files and append them along with MDX docs.
With a single command, I’m able to generate docs of the entire project. This has been very helpful for me as at Juspay invests a lot on new tech, and we have our own custom components which we reuse in more than 20 dashboards. I hope that its useful for anyone out there.
More can be done in this project to make it more useful, right now its built with mindset to solve only my usecases. I’m open to suggestions and external contribution here.
