- candidate for v0.18
- tweaks to documentation