<table cellspacing="0" cellpadding="0" border="0" ><tr><td valign="top" style="font: inherit;">As far as improving documentation, I'd say every object in Pd-ext should be <br>documented clearly in a help patch that outlines:<br>1) what the object does<br>2) what its arguments are (and how they function)<br>3) what messages are accepted at each inlet, and output at each outlet <br>(and the meaning of those messages, unless it's obvious)<br>4) _clear_ example patch<br>5) any related objects (esp. internal objects)<br><br>If right-clicking "Help" for an object doesn't bring up a help patch, or if <br>that help patch is just a placeholder, it should be considered a bug.<br><br>-Jonathan<br><br>--- On <b>Mon, 12/13/10, Hans-Christoph Steiner <i><hans@at.or.at></i></b> wrote:<br><blockquote style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; padding-left: 5px;"><br>From: Hans-Christoph Steiner <hans@at.or.at><br>Subject: Re: [PD]
libraries in Pd-extended 0.43<br>To: "PD List" <pd-list@iem.at><br>Date: Monday, December 13, 2010, 7:35 PM<br><br><div id="yiv980320916"><div><div><br></div><div>A long standing complaint of Pd-extended is that it is hard to know what all is in it and how it got there. Plus the old build system is a bug ugly whack thing that is not understandable We've made the library template and that's working well so far. We</div><div><br></div><div>Here are some concrete steps to take on to help with this effort, either as the maintainer of a library, or just where you can help:</div><div><br></div><div>- add a page to the the downloads page <a rel="nofollow" target="_blank" href="http://puredata.info/community/projects/software/">http://puredata.info/community/projects/software/</a> (this will become <a rel="nofollow" target="_blank" href="http://puredata.info/downloads">http://puredata.info/downloads</a> soon).</div><div>- add
releases to the download page</div><div>- improving documentation</div><div>- making a Debian package</div><div>- taking a pure:dyne package and getting it ready for submission to Debian</div><div>- test releases</div><div>- update the code in the Pd-extended release branch, once that is in place</div><div><br></div><div>There is some developing documentation here, its not cast in stone yet:</div><div><br></div><div><a rel="nofollow" target="_blank" href="http://puredata.info/docs/AddingYourProjectToDownloads">http://puredata.info/docs/AddingYourProjectToDownloads</a></div><div><a rel="nofollow" target="_blank" href="http://puredata.info/docs/LibrariesInPdExtended">http://puredata.info/docs/LibrariesInPdExtended</a></div><div><a rel="nofollow" target="_blank" href="http://puredata.info/docs/developer/GettingIntoPdextended">http://puredata.info/docs/developer/GettingIntoPdextended</a></div><div><br></div><div>There is a library template too. People
aren't required to use this, but it makes things a lot easier IMHO:</div><div><br></div><div><a rel="nofollow" target="_blank" href="http://puredata.info/docs/developer/LibraryTemplate">http://puredata.info/docs/developer/LibraryTemplate</a></div><div><br></div><div>.hc</div><div><br></div><div><br></div> <div class="yiv980320916gmail_quote">On Mon, Dec 13, 2010 at 6:05 PM, Hans-Christoph Steiner <span dir="ltr"><<a rel="nofollow" ymailto="mailto:hans@at.or.at" target="_blank" href="/mc/compose?to=hans@at.or.at">hans@at.or.at</a>></span> wrote:<br> <blockquote style="border-left: 1px solid rgb(204, 204, 204); margin: 0px 0px 0px 0.8ex; padding-left: 1ex;" class="yiv980320916gmail_quote"> <div style="word-wrap: break-word;"> <div><br></div> <div>Hey Alan,</div> <div><br></div> <div>Thanks for the offer! Maintaining a library mostly means keeping track of the issues and seeing that they get addressed. Things range from making releases,
posting releases, fixing bugs, accepting patches, etc. It can also mean doing all of the work, if you so choose. I will help out where I can, and I'm sure many others will too.</div> <div><br></div> <div>You can take on any library you want, I always say its best to take on one that you feel personally invested in.</div> <div><br></div> <div>.hc</div> <div> <div></div> <div class="yiv980320916h5"><br> <div> <div>On Dec 13, 2010, at 5:25 AM, ALAN BROOKER wrote:</div><br> <blockquote type="cite">Sevy, <div><br></div> <div>How is this a constructive comment? In fact, how is it even constructive criticism? Your proof of the saying that goes,</div> <div> "You can either not say anything and risk people thinking your ignorant or you can open your mouth and prove it".</div> <div><br></div> <div>Really I think you need to grow up, I am really surprised at just how immature you are. If you don't like the people on the list
then subscribe.</div> <div><br></div> <div>Maybe I am wrong however, if you have a grievance then put it forward in a sensible way so that things can be worked out? If there is something I can do let me know? I think to have bad feelings with anyone on this list is not a good thing.</div> <div><br></div> <div>Hans, I may be able to maintain a some libraries and it is something I'm looking into, my programming experience is limited but would like to contribute.</div> <div><br></div> <div><br></div> <div><br> <div class="yiv980320916gmail_quote">On Mon, Dec 13, 2010 at 3:58 AM, sevy <span dir="ltr"><<a rel="nofollow" ymailto="mailto:ydegoyon@gmail.com" target="_blank" href="/mc/compose?to=ydegoyon@gmail.com">ydegoyon@gmail.com</a>></span> wrote:<br> <blockquote style="border-left: 1px solid rgb(204, 204, 204); margin: 0px 0px 0px 0.8ex; padding-left: 1ex;" class="yiv980320916gmail_quote">this basically shows you have 3
collaborators<br>and you call it a 'community' <div> <div></div> <div><br><br> <div class="yiv980320916gmail_quote">On Sun, Dec 12, 2010 at 9:03 PM, Hans-Christoph Steiner <span dir="ltr"><<a rel="nofollow" ymailto="mailto:hans@eds.org" target="_blank" href="/mc/compose?to=hans@eds.org">hans@eds.org</a>></span> wrote:<br> <blockquote style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;" class="yiv980320916gmail_quote"><br>One of the goals for Pd-extended 0.43 is to have all libraries have a maintainer, so Pd-extended isn't just a collection of lots of semi-working code. The end goal is to have a maintainer for all libraries that are included in Pd-extended. Here's the current list based on my knowledge:<br> <br><a rel="nofollow" target="_blank" href="http://puredata.info/docs/LibrariesInPdExtended">http://puredata.info/docs/LibrariesInPdExtended</a><br><br>If you are interested in becoming the
maintainer of any of the libraries that are currently lacking a maintainer, please add your name next to the library in question. Once you get the library up-to-date for Pd-extended, we can move it up to the "maintained" section on the top. Here's a rough sketch of the process of getting libraries into Pd-extended:<br> <br><a rel="nofollow" target="_blank" href="http://puredata.info/docs/developer/GettingIntoPdextended">http://puredata.info/docs/developer/GettingIntoPdextended</a><br><br>.hc<br><br><br><br>----------------------------------------------------------------------------<br> <br>All mankind is of one author, and is one volume; when one man dies, one chapter is not torn out of the book, but translated into a better language; and every chapter must be so translated.... -John Donne<br><br><br><br> _______________________________________________<br><a rel="nofollow" ymailto="mailto:Pd-list@iem.at" target="_blank"
href="/mc/compose?to=Pd-list@iem.at">Pd-list@iem.at</a> mailing list<br>UNSUBSCRIBE and account-management -> <a rel="nofollow" target="_blank" href="http://lists.puredata.info/listinfo/pd-list">http://lists.puredata.info/listinfo/pd-list</a><br> </blockquote></div><br></div></div><br>_______________________________________________<br><a rel="nofollow" ymailto="mailto:Pd-list@iem.at" target="_blank" href="/mc/compose?to=Pd-list@iem.at">Pd-list@iem.at</a> mailing list<br>UNSUBSCRIBE and account-management -> <a rel="nofollow" target="_blank" href="http://lists.puredata.info/listinfo/pd-list">http://lists.puredata.info/listinfo/pd-list</a><br> <br></blockquote></div><br></div>_______________________________________________<br><a rel="nofollow" ymailto="mailto:Pd-list@iem.at" target="_blank" href="/mc/compose?to=Pd-list@iem.at">Pd-list@iem.at</a> mailing list<br>UNSUBSCRIBE and account-management -> <a rel="nofollow" target="_blank"
href="http://lists.puredata.info/listinfo/pd-list">http://lists.puredata.info/listinfo/pd-list</a><br> </blockquote></div><br></div></div> <div><span style="text-transform: none; text-indent: 0px; border-collapse: separate; font: medium Helvetica; white-space: normal; letter-spacing: normal; color: rgb(0, 0, 0); word-spacing: 0px;"><span style="text-transform: none; text-indent: 0px; border-collapse: separate; font: medium Helvetica; white-space: normal; letter-spacing: normal; color: rgb(0, 0, 0); word-spacing: 0px;"> <div style="word-wrap: break-word;"> <div> <div style="font-size: 12px;"><br>----------------------------------------------------------------------------<br></div></div> <div><br></div></div></span>“We must become the change we want to see. - Mahatma Gandhi</span> </div><br></div><br>_______________________________________________<br><a rel="nofollow" ymailto="mailto:Pd-list@iem.at" target="_blank"
href="/mc/compose?to=Pd-list@iem.at">Pd-list@iem.at</a> mailing list<br> UNSUBSCRIBE and account-management -> <a rel="nofollow" target="_blank" href="http://lists.puredata.info/listinfo/pd-list">http://lists.puredata.info/listinfo/pd-list</a><br><br></blockquote></div><br></div><br><div> <span class="yiv980320916Apple-style-span" style="font-size: 12px;"><br class="yiv980320916Apple-interchange-newline"></span><span class="yiv980320916Apple-style-span" style="font-size: 12px;"><span class="yiv980320916Apple-style-span" style="border-collapse: separate; border-spacing: 0px; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; text-indent: 0px; text-transform: none; orphans: 2; white-space: normal; widows: 2; word-spacing:
0px;"><div><br></div><div>----------------------------------------------------------------------------<br></div><div><br class="yiv980320916khtml-block-placeholder"></div><div>News is what people want to keep hidden and everything else is publicity. - Bill Moyers</div><br class="yiv980320916Apple-interchange-newline"></span></span> </div><br></div><br>-----Inline Attachment Follows-----<br><br><div class="plainMail">_______________________________________________<br><a ymailto="mailto:Pd-list@iem.at" href="/mc/compose?to=Pd-list@iem.at">Pd-list@iem.at</a> mailing list<br>UNSUBSCRIBE and account-management -> <a href="http://lists.puredata.info/listinfo/pd-list" target="_blank">http://lists.puredata.info/listinfo/pd-list</a><br></div></blockquote></td></tr></table><br>