some guidelines:

volumes, pitches and durations should be loud, high and long enough to be heard on laptop speakers.

Help examples should not require resources (esp. sound files) not present on the default distribution. If necessary a small example resource could be added to the distribution.

portions of examples meant to be executed in one enter key press should be in open parens as follows.

(
example code..
goes..
..here
)

Don't put code that can't be executed in one press between such an arrangement of parens.


(// dont put a comment here. it makes it hard to select.
..example code..
)

(
^dont put a space after the open paren either.
it makes you have to select right on the paren rather than anywhere on that line.
)

Examples should work. Run through them to check after you change your code.