documentation improvements
Merge branch 'multithreading'