update doco with threading issue
Merge remote-tracking branch 'soniah/master'