try to fix the toctree in a semi-meaningful way.
DOC/EXAMPLES fix more documentation errors, deprecated api usages.