update docs and test examples for changes in 0.12