improvements to examples