Add a note to the worker API docs about long-running thread workers

[davep]

Following on from the work done in #2545 and the use of thread workers there: add a note to the documentation for thread-based workers that having long-running thread workers is going to be a bad idea.