[Haskell-cafe] Hackage package "synopsis" sections
Michael Snoyman
michael at snoyman.com
Mon Sep 15 17:40:35 UTC 2014
On Mon, Sep 15, 2014 at 8:38 PM, Richard Lewis <richard at rjlewis.me.uk>
wrote:
> Hi there,
>
> If any of you have ever used CPAN you may
> agree with me that the synopsis sections
> customarily included in each package's POD
> are generally invaluable for getting a quick
> overview of how to use the facilities
> provided by that package.
>
> I wonder if we might be able to encourage
> the Hackage community to do something
> similar? Perhaps in the cabal description
> authors could include a synopsis with a
> few code examples?
>
> Obviously, I ought to start the ball rolling but
> I don't actually have any code published on
> Hackage.
>
> Any thoughts?
>
> Richard
> --
> -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
> Richard Lewis
> @lewisrichard
> http://web.rjlewis.me.uk/
> -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
> _______________________________________________
> Haskell-Cafe mailing list
> Haskell-Cafe at haskell.org
> http://www.haskell.org/mailman/listinfo/haskell-cafe
>
I'd love to see it work similar to the new changelog feature. Imagine if
you could add a `Synopsis.md` file to your cabal sdist, and Hackage
rendered it to HTML and displayed it?
Michael
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.haskell.org/pipermail/haskell-cafe/attachments/20140915/4e4163a4/attachment.html>
More information about the Haskell-Cafe
mailing list