this better tells people when to read this section.
Assume people first try just editing files, and only write custom code if they are getting fancy.
there was already some mention of it so move the longer mention to just after the initial mention
There were some docs, then some huge listings, then more docs; I'm guessing people often don't scroll down past the huge listings so move them to the bottom.
…asing timeout for ConcurrentSocketActorSpec
… as suggested by Roland