doc edits
readme edits
tidying
split mutable maths functions into separate protocol