tidied up protocol documentation