readme, refactored for consistency