updated configuration, code comments and content of "simple" examples. And made a couple of enhancements to advanced examples
documented some of the markdown features, added "Features" section to readme