2 ms·
I was writing a reply to this, but it got long enough that I decided to make it a standalone blog post. http://softwaresimply.blogspot.com/2016/12/on-haskell-d
by mightybyte 10y ago
I was writing a reply to this, but it got long enough that I decided to make it a standalone blog post.
http://softwaresimply.blogspot.com/2016/12/on-haskell-documentation.html http://softwaresimply.blogspot.com/2016/12/on-haskell-docume...
- bojo 10y agoI was considering writing roughly the same thing you did, thanks. There's a lot of terrible documentation in every language, but I think it may be a losing battle to show this as a counter example unfortunately. I think it's just that the gap to get proficient with Haskell for an imperative programmer is a hurdle they are blind to (I was blind myself!), and they assume a few simple tutorials will bootstrap them into the language like it did the other handful they learned. This is clearly an education problem, but I guess we still have a ways to go to get acceptance.
- mightybyte 10y ago> I think it may be a losing battle to show this as a counter example unfortunately. Yeah, my intent wasn't to suggest that all non-haskell docs suck. But to show how other languages are much more howto/tutorial oriented, which I didn't appreciate as much before I had to look at ACE recently.