docs: Improve documentation around options, especially metadata

Had the read the code to easily see what values I could pass into options like below. Shouldn't have to read the code.

``` js
var options = {
  data: data, // png image data
  metadata: {
    contentType: 'image/png'
  }
};

bucket.write('image.png', options, callback);
```
