If you’re a library/tool author, please put a small code demo in the readme, or at least link to some. I’d like to see what the syntax looks like at a glance. I think it helps adoption for all projects, including this one.
I agree. It helps show off your proposed model for the problem, your priorities, and other factors like your style. I think these go a long way towards “grokking” the library.
If you're interested in understanding more about what Hardcaml is trying to achieve, you might enjoy this interview with Andy Ray, the primary author of the library:
8 comments
[ 3.0 ms ] story [ 28.1 ms ] threadhttp://www.ujamjar.com/hardcaml/
https://signalsandthreads.com/programmable-hardware/
It's a podcast, but you can read the transcript too, if you're not into that format.
One thing that really struck me about the conversation is how much of the benefit that Andy sees coming from Hardcaml is from the testing story.
[1] No page for Handel unfortunately, but its successor Handel-C has a page: https://en.wikipedia.org/wiki/Handel-C#History
[2] https://en.wikipedia.org/wiki/Standard_ML