Fantastic idea,
I will be working on a few tutorials myself soon.
I suppose we should design a template for tutorials to keep things standard,
anyone with documentation experience have any suggestions? an initial thought would be following Chris's format with html plus example patches...
Ben
----- Original Message ----- From: Hans-Christoph Steiner hans@eds.org Date: Sunday, April 27, 2003 11:28 am Subject: RE: [PD] teaching PD to newbies [WAS: Re: [GEM] GEM users request ]
It would be really great if we could combine all of the existing tutorialsout there into one coherent, navigatible set of tutorials. Just like PDDP is becoming the central repository for docs, and the CVS is the centralrepository for externals, there should also be a central repository for tutorials.
I think that the tutorials and PDDP should ultimately be part of the pure-data.sf.net CVS. It makes working collaboratively much easier than if these files are spread out all over the net.
Once this semester is over, and I get some breathing room, I am going to make a "Getting Help" section for pure-data.org with links to all of the docs and tutorials I can find. If all of the docs and tutorials were interconnected and easily navigatible, that would be an amazing resource.
.hc
On Fri, 25 Apr 2003, David Sabine wrote:
Hello all,
This type of idea is inline with my eventual goal for the PDDP
files.>
I have felt that it's very important to, aside from brief and
precise> explanations of the inlets/outlets and arguments of each object, offer at
least one example of the object being used in a real and typical
situation.> I haven't written any complete tutorials, because I haven't felt that it was
part of the PDDP mandate -- however, I've been able to offer some 'real-world' examples of the objects in context.
As tutorials are written and completed I would like to provide
web links in
the PDDP to relevant tutorials. For example, if an online
tutorial shows a
typical usage of [loadbang] (or anything else), then the
[loadbang].pd help
document should provide a link to that tutorial.
Obviously, [loadbang] is rather straight forward, but other help
files would
benefit a lot from online tutorials.
For those writing these wonderful tutorials - I would appreciate
if you
contact me if you feel any of the PDDP files deserve a link to your tutorial.
Regards, Dave Sabine
p.s.: I like this thread a lot. There have been some good ideas
- many of
which are possible, important, and will make PD a more valuable
and useable
tool for all users.
PD-list mailing list PD-list@iem.kug.ac.at http://iem.kug.ac.at/cgi-bin/mailman/listinfo/pd-list
zen
\[D[D[D[D
PD-list mailing list PD-list@iem.kug.ac.at http://iem.kug.ac.at/cgi-bin/mailman/listinfo/pd-list