Some notes on testing API

these came in useful while developing against #30