added some documentation to examples