More documentation provides less guesswork, therefore we'd like to see more documentation in new API.