more protocol doc improvements