Hacker News new | ask | show | jobs
by MrRoger 4429 days ago
Why you never document your code? You didn't document your Clojure libs and now you're continuing the trend with Haskell. If you're going to make libs, please provide the adequate documentation with examples of usage in the code. I'm not gonna keep going back to the README. I'm going to use Hoogle and Hackage. All those comments in the README could be looking all pretty on Hackage right now.
3 comments

huh, Chris definitely should add some comments to his code. I'll tease him about it for the next week!
Is there a particular Clojure library that you need more documentation for?

I'll transfer the README docs over to Haddock/lhs when I do the next non-trivial release.

that is frustrated me when entering functional language world. rarely good document compared to other language. In Perl, many modules will have their own tutorial