example doc improvements