VE-471: add doc comments where applicable and remove where not.