[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [sc-users] helpfiles



This is the difference between reference documentation and a tutorial. The doc in SC is (unusually I suppose) a combination of the two, but a reasonably comprehensive tutorial is still a significant lack, IMHO. I'm hoping to do some work on this over the holidays. More 'topics' helpfiles would also be helpful though.

S.

On 17 Dec 2004, at 17:23, James Harkins wrote:

This comment illustrates exactly the problem with the
bulk of the documentation. Our tendency is to document
classes, not usage patterns. This makes the
documentation useful for people who already know what
they're doing, but not so helpful for people who
don't.

So, when a new help file is committed, we
automatically assume that it's for a new class.

There are a lot of undocumented classes still, but I
for one would like to see more help files on usage
patterns and coding strategies appropriate to
real-world musical tasks. I've written a few, and will
continue to write them.

Tuppence...
hjh

--- Tom Tlalim <ttlalim@xxxxxxxxx> wrote:

hi julian,

is the Randomness object a part of the distro?


On 17 Dec 2004, at 14:11, Julian Rohrhuber wrote:

There is a new helpfile on Randomness by Alberto
de Campo.

=====
____   James Harkins /// dewdrop world
\  /   jamshark70@xxxxxxxxx
 \/    http://www.dewdrop-world.net

"... love and hot pants, peace, harmony..."
  -- Dick Lee, Hot Pants: The Musical
_______________________________________________
sc-users mailing list
sc-users@xxxxxxxxxxxxxxx
http://www.create.ucsb.edu/mailman/listinfo/sc-users