please avoid mentioning `Await.result` in code samples, better use `onComplete`

Also: while touching this, please add to the warning above that using gracefulStop to “make sure that system.actorOf will work with the same name” does not work. I don’t think we want to actually “fix” this, and the problem will go away in a few months.