API Docs: thread

[steveklabnik]

Part of #29329

http://doc.rust-lang.org/std/thread/

Here's what needs to be done to close out this issue:

• the module docs are written a while ago, and contain some questionableish advice. It's not actually bad, it's just not the way I'd orient all of this. A particularly enthusiastic contributor could toss this out and re-write it from scratch. If the rest of this work gets done, we can close the ticket without doing this, but it would be nice.
• Builder's docs are... okay. Just very uninspired.
• JoinHandle doesn't go into enough detail, and should show off, for example, the detach behavior.
• LocalKey could use some links and general cleanup.
• Thread has very little and very boring docs.
• panicking could use some more advice on when to use this.
• park should have its module documentation inlined here, and cleaned up.
• park_timeout could use links to park
• spawn needs a lot more docs generally. It's the main interface to this module!
• yield_now doesn't explain any of the "why".
• Result should at least show off the "use std::thread; thread::Result" pattern, like all module-specific Result types.

[steveklabnik]

I am happy to mentor anyone who wants to tackle this issue.

[zimurgh]

I would be interested in taking on the documentation improvement of Builder as a starter. I'd take on more, but no need to get ahead of myself.

[steveklabnik]

@OldManMike awesome! Please let me know if you need anything.

I am not (by any means) an expert on this topic but I'd love to help on this one, as @steveklabnik says: writting docs is the best way to learn something

I believe I will be taking the joinHandle and Thead docs