notes on API docs (attached to releases in obspy/obspy from now on)