I can't believe I'm even saying this in 2022, but if you're writing docs for JS libraries and you're writing out type signatures, USE TYPESCRIPT NOTATION, NOT HASKELL NOTATION. There is no scenario in which the latter is more helpful when describing the shape of JS code.
Conversation
Specifically looking at mostcore.readthedocs.io/en/latest/api. right now because I'm upset enough to name and shame, but it was unfortunately just the drop that made the cup runneth over, if you're foolish enough to go anywhere near functional programming toolkits for JS.
2
16
Replying to
They are using… curried notation for uncurried functions. And they even have typescript types already. How does this help at all? 😩
- mostcore.readthedocs.io/en/latest/api.
- github.com/mostjs/core/bl
(I'd be grumpy too)