Update README file

Update README file.

Now it actually have informationon what you cna do with
the gcloud package.

R=kustermann@google.com, wibling@google.com
BUG=

Committed: https://github.com/dart-lang/gcloud/commit/b09f3f89e2c0086c39f2808a6741c4425d6fff57

[kustermann, 2015-03-24 17:53:28]

LGTM

https://codereview.chromium.org/1030593003/diff/20001/README.md
File README.md (right):

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode44
README.md:44: var jsonCredentials = new
File('my-project.json').readAsStringSync());
Remove final ')'

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode76
README.md:76: When other parts of the application is running inside a service
scope with
is -> are

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode90
README.md:90: that when running Dart on App Engine assessing the `gcloud`
services is well
assessing -> accessing

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode91
README.md:91: integrated into both the local developemnt server and the
authentication model
developemnt -> development

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode98
README.md:98: [https://cloud.google.com/datastore/][Datastore] for more
information.
Is this link valid?

I thought it's either (...)[...] or [...](...)

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode100
README.md:100: The Cloud Datastore API provide mapping of Dart objects to
entities stored
provide -> provides a

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode116
README.md:116: class must also inherit from `Model`. Now to store into the
Datastore create
to store -> to store an object in the

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode150
README.md:150: var bucket = storage.createBucket('my-bucket');
is an 'await' missing here?

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode157
README.md:157: bucket.read('my-object').pipe(new
File('my-file-copy.txt').openRead());
openRead -> openWrite

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode161
README.md:161: Google Cloud Pub/Sub provide many-to-many, asynchronous
messaging. See the
provide -> provides

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode164
README.md:164: Cloud Pub/Sub ues two concepts for messaging. _Topics_ are used
if you want
ues -> uses

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode166
README.md:166: receive the messages.
Maybe add: "This de-couples the producer of a message from the consumer of a
message.".

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode179
README.md:179: await pullEvent.acknowledge()
maybe add a comment that `pullEvent` has the real data - or add a
print(pullEvent...)

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode194
README.md:194: `endpoint` argument. The server will acknowledge the reception of
the message
will -> needs to

[Søren Gjesse, 2015-03-25 08:28:27]

Thanks Martin

https://codereview.chromium.org/1030593003/diff/20001/README.md
File README.md (right):

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode44
README.md:44: var jsonCredentials = new
File('my-project.json').readAsStringSync());
On 2015/03/24 17:53:28, kustermann wrote:
> Remove final ')'

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode76
README.md:76: When other parts of the application is running inside a service
scope with
On 2015/03/24 17:53:28, kustermann wrote:
> is -> are 

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode90
README.md:90: that when running Dart on App Engine assessing the `gcloud`
services is well
On 2015/03/24 17:53:28, kustermann wrote:
> assessing -> accessing

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode91
README.md:91: integrated into both the local developemnt server and the
authentication model
On 2015/03/24 17:53:28, kustermann wrote:
> developemnt -> development

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode98
README.md:98: [https://cloud.google.com/datastore/][Datastore] for more
information.
On 2015/03/24 17:53:28, kustermann wrote:
> Is this link valid?
> 
> I thought it's either (...)[...] or [...](...)

It is I think that (...)[...] is not working. At least that is what I get in the
online previewer. However I found that the label in the last [...] cannot have
underscores, so [googleapis_beta] by itself which should be equivalent to
[googleapis_beta][googleapis_beta] did not work. I had to change the label to
googleapisbeta and the link to [googleapis_beta][googleapis_beta].

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode100
README.md:100: The Cloud Datastore API provide mapping of Dart objects to
entities stored
On 2015/03/24 17:53:28, kustermann wrote:
> provide -> provides a

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode116
README.md:116: class must also inherit from `Model`. Now to store into the
Datastore create
On 2015/03/24 17:53:28, kustermann wrote:
> to store -> to store an object in the 

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode150
README.md:150: var bucket = storage.createBucket('my-bucket');
On 2015/03/24 17:53:28, kustermann wrote:
> is an 'await' missing here?

Yes, added.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode157
README.md:157: bucket.read('my-object').pipe(new
File('my-file-copy.txt').openRead());
On 2015/03/24 17:53:28, kustermann wrote:
> openRead -> openWrite

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode161
README.md:161: Google Cloud Pub/Sub provide many-to-many, asynchronous
messaging. See the
On 2015/03/24 17:53:28, kustermann wrote:
> provide -> provides

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode164
README.md:164: Cloud Pub/Sub ues two concepts for messaging. _Topics_ are used
if you want
On 2015/03/24 17:53:28, kustermann wrote:
> ues -> uses

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode166
README.md:166: receive the messages.
On 2015/03/24 17:53:28, kustermann wrote:
> Maybe add: "This de-couples the producer of a message from the consumer of a
> message.".

Done.

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode179
README.md:179: await pullEvent.acknowledge()
On 2015/03/24 17:53:28, kustermann wrote:
> maybe add a comment that `pullEvent` has the real data - or add a
> print(pullEvent...)

Added

print(pullEvent.message.asString);

https://codereview.chromium.org/1030593003/diff/20001/README.md#newcode194
README.md:194: `endpoint` argument. The server will acknowledge the reception of
the message
On 2015/03/24 17:53:28, kustermann wrote:
> will -> needs to

Done.

[wibling, 2015-03-25 09:59:02]

Looks good. A few comments below.

https://codereview.chromium.org/1030593003/diff/40001/README.md
File README.md (right):

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode3
README.md:3: This `gcloud` packages provides a high level "idomatic Dart"
interface to
NIT: This -> The
and
packages -> package

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode21
README.md:21: The code snippets below demonstrating to use of this package all
assume that
'demonstrating to use of this' -> demonstrating the use of this'

or 

'demonstrating how to use this'

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode50
README.md:50: ..addApp(Storage.SCOPES)
.addApp -> .addAll

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode72
README.md:72: // Run application which uses these services.
NIT: 'which uses' -> 'using'

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode77
README.md:77: these services registered they are directly available through
getters like this:
I would change the above to something like.

The services registered with the ServiceScope can now be reached from within all
the code running in the same scope using the below getters:

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode94
README.md:94: 
I would rephrase the above to something like:

The `gcloud` package is also integrated in the Dart [appengine] package. This
means all the `gcloud` services are available via the appengine context and the
authentication required to access the Google Cloud Platform services is handled
automatically. 

Ideally I would add an example showing how the above looks in code?

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode130
README.md:130: var persons = await db.query(Person).run().toList();
Don't you need to have brackets like 

(await db.query(Person).run()).toList()

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode139
README.md:139: ## Could Storage
Could -> Cloud

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode140
README.md:140: Google Cloud Storage provide a highly available object storage
(aka BLOB
NIT: object storage -> object store

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode166
README.md:166: receive the messages. This de-couples the producer of a message
from the
NIT: de-couples -> decouples

https://codereview.chromium.org/1030593003/diff/40001/README.md#newcode206
README.md:206: When running these tests the following environment variables
needs to be set:
NIT: needs -> need

[Søren Gjesse, 2015-03-25 14:54:21]

Committed patchset #4 (id:60001) manually as
b09f3f89e2c0086c39f2808a6741c4425d6fff57 (presubmit successful).