document and example updates