Oscillations documentation and small changes to some services.

Should be pretty quick PR to merge into master-contains the oscillations documentation draft and some very minor changes to the other services.