<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">If there's an Example section, it might actually be a good idea to include it on the package's hackage page, too.<div>From a usability point of view, CPAN is much more helpful than the relatively spartan hackage description - if you're looking for a particular set of functionality, being able to filter out misses quickly is really nice.</div><div><br></div><div>mark</div><div><br><div><div>On 29/09/2009, at 1:11 PM, Hong Yang wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div>A Cook Book is good but relies on people specifically working on it. I think most of the package authors submit their packages because they themselves need the modules in his real world.</div> <div>&nbsp;</div> <div>I think package authors adding examples in the Descriptions section is a good start when they submit their packages. You do want to&nbsp;facilitate people understanding and using your modules, right?</div> <div>&nbsp;</div> <div>Maybe later on we can add an Example section to Description, Synopsis, and Documentation sections produced by Haddock.</div> <div>&nbsp;</div> <div>Also, having a section for comments is helpful. This is the case especially when there are several similar packages coexisting, comments can help people choose which one to use.</div> <div>&nbsp;</div> <div>Thanks,</div> <div>&nbsp;</div> <div>Hong</div> <div><br><br></div> <div class="gmail_quote">On Mon, Sep 28, 2009 at 9:55 PM, Casey Hawthorne <span dir="ltr">&lt;<a href="mailto:caseyh@istar.ca">caseyh@istar.ca</a>&gt;</span> wrote:<br> <blockquote class="gmail_quote" style="PADDING-LEFT: 1ex; MARGIN: 0px 0px 0px 0.8ex; BORDER-LEFT: #ccc 1px solid"> <div class="im">On Mon, 28 Sep 2009 21:50:14 -0500, you wrote:<br><br>&gt;Good libraries are not enough for a language to go beyond mere existence.<br>&gt;There must exist good documents, i.e., good tutorials, good books, and good<br> &gt;explanations and examples in the libraries, etc, that are easy for people to<br>&gt;learn and use. In my humble opinion, Haskell has a lot of libraries, but<br>&gt;most of them offer few examples of how to use the modules. In this regards,<br> &gt;Perl is much much better.<br><br>Good thought!<br><br>Is there a good way to add Haskell examples to the libraries?<br><br><br></div>A Haskell CookBook might be just the ticket, also.<br> <div> <div></div> <div class="h5"><br>--<br>Regards,<br>Casey<br>_______________________________________________<br>Haskell-Cafe mailing list<br><a href="mailto:Haskell-Cafe@haskell.org">Haskell-Cafe@haskell.org</a><br><a href="http://www.haskell.org/mailman/listinfo/haskell-cafe" target="_blank">http://www.haskell.org/mailman/listinfo/haskell-cafe</a><br> </div></div></blockquote></div><br> _______________________________________________<br>Haskell-Cafe mailing list<br><a href="mailto:Haskell-Cafe@haskell.org">Haskell-Cafe@haskell.org</a><br>http://www.haskell.org/mailman/listinfo/haskell-cafe<br></blockquote></div><br></div></body></html>