readme and code clarification