Re:I've never seen a language's style guide recommend avoidi...
by timnic on Wednesday July 23, 2014 @04:47AM
(#8073406)
Yes, obviously the examples given in the link are bad style of comments. But sometimes you need to explain the reasons behind the (Haskell) equations, just like one would do in a Math paper. So there's a use case for the literate Haskell files *.lhs (http://www.haskell.org/haskellwiki/Literate_programming).
What the article omits is the suggestion of commenting the right way, i.e. adding reasoning or the description of the high level logic behind the code.