api doc improvements
important notes for New Relic