[Haskell-cafe] Hackage package "synopsis" sections

Brandon Allbery allbery.b at gmail.com
Mon Sep 15 23:22:46 UTC 2014


On Mon, Sep 15, 2014 at 6:54 PM, Jonathan Paugh <jpaugh at gmx.us> wrote:

> IIRC, adding Markdown to Hadock was suggested on this list before, and
> the major argument against it was that Markdown didn't have a standard.
>

The biggest argument against it is that several Markdown conventions
conflict with existing Haddock conventions, so you don't get to mix and
match and you may have to specify which convention you're using. Note that
a flag day to deprecate the old Haddock is not an option, unless you are
offering to rewrite the haddocks of every existing package.

-- 
brandon s allbery kf8nh                               sine nomine associates
allbery.b at gmail.com                                  ballbery at sinenomine.net
unix, openafs, kerberos, infrastructure, xmonad        http://sinenomine.net
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.haskell.org/pipermail/haskell-cafe/attachments/20140915/5fba8764/attachment.html>


More information about the Haskell-Cafe mailing list