better encapsulation of the executor shutdown
added a troubleshooting section