News for hackers. Stuff that matters.

A comment on Reasons to avoid code comments . Parent comment

Re:Reasons to avoid code comments by tome on Saturday July 13, 2013 @10:19AM (#6037576)
Types are typically better documentation than comments:

    addCD :: CDCollection -> String -> Maybe String -> NonNegativeInt -> NonNegativeDouble -> Either FailureType CDCollection
This answers all your questions except for "Which related methods are available?" and the anwsers are checked for correctness at compile time!
[ Parent | on HN ]
Re:Reasons to avoid code comments by ExpiredLink on Saturday July 13, 2013 @03:07PM (#6038393)
You could just write a monad instead.
[ Parent | on HN ]