modifications on API doc