clarified descriptions and method stubs based on code review