readme clarification and code cleanup