The spec looks good. I have a couple of comments.
* The workshops should absolutely tie into the help system. That is one of the key ideas of the open source workshops for me: that all of the materials would be built into Pd and integrated into the Pd help system. All the students would need to do to prepare for a workwhop is install Pd. The references in those workshops/tutorials would lead directly to the canonical Pd help.
* I think that if we have a search function, then the browse categories should be as broad as possible, like just "control", "audio", "video" sounds pretty good to me. If the categories are too narrow, it makes it hard to browse just to see what's available. Also, more categories means more work to organize everything into those categories.
.hc
On Apr 24, 2005, at 5:33 PM, B. Bogart wrote:
Hey all,
I've added a few things to the wiki page:
https://puredata.org/Members/bbogart/PDDocumentationStructure
A crack at:
- spec for the searching of help files.
- organization of pd "help" pull-down menu.
- functional catagories for PD externals/objects.
Please take a look and contribute!
B. _______________________________________________ PD-dev mailing list PD-dev@iem.at http://lists.puredata.info/listinfo/pd-dev
________________________________________________________________________ ____
"If nature has made any one thing less susceptible than all others of exclusive property, it is the action of the thinking power called an idea, which an individual may exclusively possess as long as he keeps it to himself; but the moment it is divulged, it forces itself into the possession of everyone, and the receiver cannot dispossess himself of it."
- Thomas Jefferson