> The documentation and tutorials for various libraries is often incomplete, outdated and written in a hard to grok plain text document
I am keen to make an effort to remove outdated documentation and to complete incomplete documentation. If you give specific examples I shall try to do so.
> Asking questions can also be painful as there’s definitely a tinge of elitism to some of the power members.
Could you say which forums you discovered "elite power members"? For example, was it Reddit, Haskell-Cafe mailing list, #haskell IRC channel, Discord server?
> Secondly, the conventions that are often encouraged go against writing clear and understandable code. Function names are small. You have interface functions (doThis) that exist just to call private functions (doThis’).
For better or worse, that's the way the community likes to program. I'm not sure there's much I can do about that unless you have specific examples of code that could be rewritten to be clearer.
> These odd conventions get compounded by a lot of warts on the language itself.
Did you have any specific warts in mind?
> For feature flags there’s a standard set of 20 that every experienced Haskeller turns on but good luck finding that out as a beginner, and good luck finding out that’s why the example isn’t working for you.
Were there specific "feature flags" (called "extensions" in GHC) that you needed to turn on but that the compiler didn't tell you that you needed to turn on? That's uncommon (though it is possible, OverloadedStrings is one such example).
Which examples did you try that didn't work because they didn't mention which extensions needed to be enabled? If you report them to me I will try to get them fixed upstream.
> The repl often breaks
Could you say more about in which way the repl ("GHCi") often breaks?
> And you sometimes run into hidden libraries that are in your project but arent accessable until you import them.
Could you say more? That sounds like something that could well be true but I can't see how it's a problem. You have to import libraries in many languages (Julia, Python, ...). What went wrong here?
Thanks for any light you may be able to shed.