improve intro documentation
rename shutdownThread
comment about concurrency