update documentation about threads