docs: jsdoc + travis auto build to gh-pages.

[stephenplusplus]

work in progress

RE: #125

Preview:
JSDoc-rendered HTML: http://stephenplusplus.github.io/gcloud-node

Readme changes: https://github.com/stephenplusplus/gcloud-node/tree/docs

[stephenplusplus]

Let me know if/when this is merge-worthy, and I'll do a rebase and rebuild of the docs so we're current.

[silvolu]

Oh, I thought it was still WIP from the commit message :)

Looks good to me, please go forward. I'll then make some tweaks that we'll discuss later!

[stephenplusplus]

Re-built :)

[rakyll]

Is it possible to remove TODOs and private types/members/methods from docs? We should generate docs only for user-facing stuff.

[stephenplusplus]

Poll time! Do you think the docs should be:

var dataset = new Dataset(){};

or a real use case:

var gcloud = require('gcloud');
var dataset = new gcloud.datastore.Dataset({});

?

[silvolu]

I vote real use case.

[rakyll]

I vote for the real use case too. Maybe we don't need to mention var gcloud = require('gcloud') each time.

[stephenplusplus]

Holy moly, the big PR is updated! http://stephenplusplus.github.io/gcloud-node/ for a preview.

[rakyll]

Looks great!

[silvolu]

Great, thanks!