Review needed

[mattheworiordan]

@paddybyers and @kouno, please can you review my changes in the docs repo over the last few days, see 8a62a69...source

The biggest chunks of work are:

• Reorganisation of the client library developer guide sections with lots of new content
• Support for wider variable interpolation within code examples
• Update of out of date documentation include Authentication, WebSocket & Comet transports, Encryption, Real-time Protocol, REST API etc. I am focussing on this now because I want to help client lib developers by having docs that are up to date. @paddybyers especially, please can you review my changes as it's quite likely there are still parts that are wrong. I am less worried about missing docs however quite worried if the docs are wrong.
• I set up the Quick Start Guide as a test to see if I could get the "Try it" live code editor working again properly with our JSBin. This all works now and the workflow is actually quite easy, you can either work in repo itself and the changes to JSBin are pushed up live when running guard, or you can edit in JSbin and then export back to docs by appending .textile to the URL in JSBin.

Please can you review these changes as soon as possible as I will be telling all client library developers that the documentation in those sections is now mostly up to date.

@kouno we are also now ready to get going with integrating our examples into the docs repo.

[mattheworiordan]

N/A