further API doc updates