better documentation for the new examples
added features to this example