updatd examples and documentation