add annotation, readme, test cases