Improved OTP API documentation [AEROGEAR 761]