yet more documentation slowly coming into place