improved example documentation