added annotations to each method