Added documentation of the scripting environment
Replaced 'speed' with 'velocity' where necessary

The use of 'speed' for a vector (i.e. speed * direction) was
linguistically wrong.