Updated API developer documentation (#1912, #1909)