more documentation updates, improved code for extractor examples in c++ and python