As far as improving documentation, I'd say every object in Pd-ext should be
documented clearly in a help patch that outlines:
1) what the object does
2) what its arguments are (and how they function)
3) what messages are accepted at each inlet, and output at each outlet
(and the meaning of those messages, unless it's obvious)
4) _clear_ example patch
5) any related objects (esp. internal objects)
If right-clicking "Help" for an object doesn't bring up a help patch, or if
that help patch is just a placeholder, it should be considered a bug.
-Jonathan
--- On Mon, 12/13/10, Hans-Christoph Steiner <hans@at.or.at> wrote:
From: Hans-Christoph Steiner <hans@at.or.at>
Subject: Re: [PD]
libraries in Pd-extended 0.43
To: "PD List" <pd-list@iem.at>
Date: Monday, December 13, 2010, 7:35 PM
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
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:
- add
releases to the download page - improving documentation - making a Debian package - taking a pure:dyne package and getting it ready for submission to Debian - test releases - update the code in the Pd-extended release branch, once that is in place
There is some developing documentation here, its not cast in stone yet:
There is a library template too. People
aren't required to use this, but it makes things a lot easier IMHO:
.hc
On Mon, Dec 13, 2010 at 6:05 PM, Hans-Christoph Steiner <hans@at.or.at> wrote:
Hey Alan,
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.
You can take on any library you want, I always say its best to take on one that you feel personally invested in.
.hc On Dec 13, 2010, at 5:25 AM, ALAN BROOKER wrote: Sevy,
How is this a constructive comment? In fact, how is it even constructive criticism? Your proof of the saying that goes, "You can either not say anything and risk people thinking your ignorant or you can open your mouth and prove it".
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.
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.
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.
On Mon, Dec 13, 2010 at 3:58 AM, sevy <ydegoyon@gmail.com> wrote: this basically shows you have 3
collaborators
and you call it a 'community' On Sun, Dec 12, 2010 at 9:03 PM, Hans-Christoph Steiner <hans@eds.org> wrote:
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:
http://puredata.info/docs/LibrariesInPdExtended
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:
http://puredata.info/docs/developer/GettingIntoPdextended
.hc
----------------------------------------------------------------------------
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
_______________________________________________
Pd-list@iem.at mailing list
UNSUBSCRIBE and account-management -> http://lists.puredata.info/listinfo/pd-list
_______________________________________________
Pd-list@iem.at mailing list
UNSUBSCRIBE and account-management -> http://lists.puredata.info/listinfo/pd-list
_______________________________________________
Pd-list@iem.at mailing list
UNSUBSCRIBE and account-management -> http://lists.puredata.info/listinfo/pd-list
----------------------------------------------------------------------------
“We must become the change we want to see. - Mahatma Gandhi
_______________________________________________
Pd-list@iem.at mailing list
UNSUBSCRIBE and account-management -> http://lists.puredata.info/listinfo/pd-list
----------------------------------------------------------------------------
News is what people want to keep hidden and everything else is publicity. - Bill Moyers
-----Inline Attachment Follows-----
|