readability updates, fixes markdown errors