changes to better name
adds API doc