completed docs and examples