--edits that make it more readable and added assert, more added to description