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.
João
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
immediately 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@yahoo.com wrote:
----- Original Message -----
From: Ivica Ico Bukvic ico@vt.edu To: 'Jonathan Wilkes' jancsika@yahoo.com Cc: pd-list@iem.at; 'Raphael Raccuia'
rafael.raccuia@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
that what
do you have in mind?
Multi-dimensional indexing whose data can be easily referenced by
multiple
features (object search, auto-completion, maybe other)
How will multiple dimensions help users find something that isn't there?
-Jonathan