update protocol documentation accordingly