Description
I'm very invested in Functional Programming -- Haskell was the first language that I really developed to a deep level of understanding and I always structure my projects in a functional way. This project looks great on paper for facilitating and aiding in that methodology, however I found it quite cryptic and after consuming all info contained in the documentation and examples, I wasn't able to build a satisfactory level of understanding in the practical use of this work to allow me to apply it in practice. I read through the docs 3-4 times throughout playing around with the examples provided and have watched all the videos/presentations available on youtube (on top of understanding a decent amount of 'FP arcana' and FP methodology).
Apologies if this comes across as critique -- I'm writing this as someone who is actively interested to apply this project to my work but has found a reasonably tough barrier to entry. I feel that a greater variety of examples showing a wider range of use cases would ease this a bit. Also, making it as simple as having a directory called 'examples' with loads of one page examples that people can copy/paste and play with would definitely make it quicker to get into the understanding of it.
Also, one of the things that is nice about Haskell is that it's quite easy to work with junior collaborators who are less familiar with the language -- if they are only working on pure code then there's no IO/other FP arcana to worry about and it's very hard to seriously break anything. Perhaps an interface can be implemented that pulls all the inner machinery into separate/IO modules and presents a streamlined interface for collaborators to work on pure modules with the minimal added cognitive overhead. If I get to grips with using the project in the future I'll think more about this and upload a more developed issue on the idea to the main repo.
Oscar