[PD] finding objects ?
jmmmpais at googlemail.com
Sun Sep 9 14:28:51 CEST 2012
since the plugins/programs/pdwiki/whatever can't find the right object
because this isn't properly documented, why not create a group of
voluntaries that addresses the issue of a proper documentation? things
that many developers don't do, like:
- fill in the fields of xxx-meta.pd
- make sure there is a help patch for each external (maybe even following
the pddp template)
- since we're there, test the external, hopefully in several plattforms
- add some relevant meta-tags for index searching
- manage the tag list with more actualized indexes: the 0.help.list has
very few categories, some more could help a bit sort out the externals
- add some content to the "related externals" subpatch
as there aren't that many objects being release every day, it wouldn't be
that much work. I would have no problem doing this, as long as there is
some waranty that my time won't be wasted by leaving the suggestions
somewhere in a mailbox, and not commiting the patches.
that would a) release the developers of the shore of doing a good
documentation (many don't really do it), b) in the long run maybe have a
unified documentation for the whole pd-ext, c) give a model for new (and
old?) developers to prepare their material, if they want to, d) solve one
big problem with new users, the unstructured/unfriendly documentation, and
e) world peace.
> Documentation is certainly just as important, if not more so. What I am
> suggesting is to build a framework that will be to some extent
> useful, but also whose full potential well be realized only after all the
> documentation is properly updated.
> I'm also thinking about simply getting rid of any externals in pd-l2ork
> that don't have proper or at least half-decent documentation.
> On Sep 8, 2012 1:19 AM, "Jonathan Wilkes" <jancsika at yahoo.com> wrote:
>> ----- Original Message -----
>> > From: Ivica Ico Bukvic <ico at vt.edu>
>> > To: 'Jonathan Wilkes' <jancsika at yahoo.com>
>> > Cc: pd-list at iem.at; 'Raphael Raccuia'
>> <rafael.raccuia at blindekinder.com>
>> > Sent: Friday, September 7, 2012 8:25 PM
>> > Subject: RE: [PD] finding objects ?
>> >> I can update vcf~ in the PDDP docs at some point, but aside from
>> >> do you have in mind?
>> > Multi-dimensional indexing whose data can be easily referenced by
>> > features (object search, auto-completion, maybe other)
>> How will multiple dimensions help users find something that isn't there?
10249 Berlin (Deutschland)
Tel +49 30 42020091 | Mob +49 162 6843570
Studio +49 30 69509190
jmmmpais at googlemail.com | skype: jmmmpjmmmp
More information about the Pd-list