update and clarify documentation

Hi,

A couple minor documentation updates:

1) A couple of the function call examples were using the wrong function names for their sections. Super straightforward. :)

2) I modified the description of the "derivative" function a little bit to reflect its actual behavior and to add a reference to the perSecond() function.

-- Abe