addded documentation about the existing api