minor adjustments to documentation and examples