hi, Adam, Kas, all
For a teenager we may just want to included more examples as well. I would like to start putting all of the code inline in the documentation. I am also dreaming of the day when every ugen gets an example. Maybe also the Standard Libraries. The examples will address your concerns about being clear about what all the language features are good for.
Yes. And I'd like to make sure we explicitly cover what all of the Std functions abbreviate, that should already help make them more clear.
Think some inline examples within the documentation would be useful in making this a complete reference, often the example can explain much more than the text. I keep think of some sort of integrated help system with the mini which would have examples as well.
I like your ideas about including Smirk. I think we also need to include the chuck shell, and then a brief tutorial or disciption on the miniaudicle. Maybe audicle too, though my understanding is that it isn't used very much.
The problem with the Audicle is that if you'd try to use it now with a updated manual you will be missing a lot of functionality as the included vm is rather old. I think it'd mention it in glancing now. The mini on the other hand will save people from the "scary" terminal which I found adds a lot of value for a lot of people in the beginning.
Mini makes chuck much more approachable than the terminal only. Personally I still find the ability to 'see inside the VW' really useful with the Audicle it would be great if there was a way of getting a copy of running shreds out of the mini as well. scott