update readme, clean api annotations