diff --git a/README.md b/README.md
index edde5ac88e5c..375e4e8234cb 100644
--- a/README.md
+++ b/README.md
@@ -9,8 +9,8 @@ Java idiomatic client for [Google Cloud Platform][cloud-platform] services.
[](https://www.codacy.com/app/mziccard/google-cloud-java)
[](https://www.versioneye.com/user/projects/58fe4c8d6ac171426c414772)
-- [Homepage](https://googlecloudplatform.github.io/google-cloud-java/)
-- [API Documentation](https://googlecloudplatform.github.io/google-cloud-java/apidocs)
+- [Google Cloud Platform Documentation][cloud-platform-docs]
+- [Client Library Documentation][client-lib-docs]
This library supports the following Google Cloud Platform services with clients at a [GA](#versioning) quality level:
- [Stackdriver Logging](google-cloud-logging) (GA)
@@ -42,29 +42,33 @@ This library supports the following Google Cloud Platform services with clients
- [Cloud Speech](google-cloud-speech) (Alpha)
- [Dialogflow](google-cloud-dialogflow) (Alpha)
-> Note: google-cloud-java is a work-in-progress, and may occasionally
-> make backwards-incompatible changes.
-
Quickstart
----------
+The easy way to get started is to add the umbrella package which pulls in all of the supported clients as
+dependencies. Note that even though the version of the umbrella package is Alpha, the individual clients are
+at different support levels (Alpha, Beta, and GA).
+
If you are using Maven, add this to your pom.xml file
```xml
com.google.cloud
google-cloud
- 0.32.0-alpha
+ 0.33.0-alpha
```
If you are using Gradle, add this to your dependencies
```Groovy
-compile 'com.google.cloud:google-cloud:0.32.0-alpha'
+compile 'com.google.cloud:google-cloud:0.33.0-alpha'
```
If you are using SBT, add this to your dependencies
```Scala
-libraryDependencies += "com.google.cloud" % "google-cloud" % "0.32.0-alpha"
+libraryDependencies += "com.google.cloud" % "google-cloud" % "0.33.0-alpha"
```
+It also works just as well to declare a dependency only on the specific clients that you need. See the README of
+each client for instructions.
+
For running on Google App Engine, see [more instructions here](./APPENGINE.md).
If you are running into problems with version conflicts, see [Version Management](#version-management).
@@ -274,7 +278,7 @@ The easiest way to solve version conflicts is to use google-cloud's BOM. In Mave
com.google.cloud
google-cloud-bom
- 0.32.0-alpha
+ 0.33.0-alpha
pom
import
@@ -337,4 +341,7 @@ Apache 2.0 - See [LICENSE] for more information.
[code-of-conduct]:https://github.com/GoogleCloudPlatform/google-cloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
[LICENSE]: https://github.com/GoogleCloudPlatform/google-cloud-java/blob/master/LICENSE
[TESTING]: https://github.com/GoogleCloudPlatform/google-cloud-java/blob/master/TESTING.md
+
[cloud-platform]: https://cloud.google.com/
+[cloud-platform-docs]: https://cloud.google.com/docs/
+[client-lib-docs]: http://googlecloudplatform.github.io/google-cloud-java/latest/apidocs/
diff --git a/google-cloud/README.md b/google-cloud/README.md
index ac33fd3d2343..1f149b05bae1 100644
--- a/google-cloud/README.md
+++ b/google-cloud/README.md
@@ -1,24 +1,20 @@
-Google Cloud Java Client
-==========================
+Google Cloud Java (All API Clients)
+===================================
-Java idiomatic client for [Google Cloud Platform][cloud-platform] services.
+Umbrella package that declares a dependency on all currently-available Java clients for [Google Cloud Platform][cloud-platform] services.
[](https://travis-ci.org/GoogleCloudPlatform/google-cloud-java)
[](https://coveralls.io/r/GoogleCloudPlatform/google-cloud-java?branch=master)
-[]( https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-core.svg)
+[]( https://img.shields.io/maven-central/v/com.google.cloud/google-cloud.svg)
[](https://www.codacy.com/app/mziccard/google-cloud-java)
[](https://www.versioneye.com/user/projects/58fe4c8d6ac171426c414772)
-- [Homepage](https://googlecloudplatform.github.io/google-cloud-java/)
-- [API Documentation](http://googlecloudplatform.github.io/google-cloud-java/apidocs)
+- See the [root README of google-cloud-java](https://github.com/GoogleCloudPlatform/google-cloud-java) for more details
+on which clients are alpha, beta, and GA.
-This client supports the following Google Cloud Platform services:
-
-- [Google Cloud Datastore](https://cloud.google.com/datastore/) [datastore documentation][datastore-api]
-- [Google Cloud Storage](https://cloud.google.com/storage/) [storage documentation][storage-api]
-
-> Note: This client is a work-in-progress, and may occasionally
-> make backwards-incompatible changes.
+> Note: This package does not have guaranteed stability and may experience backwards-incompatible changes.
+> This does not imply anything about the stability of the packages it depends on (i.e. the individual API client
+> libraries), only that particular dependencies may be added or removed.
Quickstart
----------
@@ -77,15 +73,3 @@ Apache 2.0 - See [LICENSE] for more information.
[code-of-conduct]:https://github.com/GoogleCloudPlatform/google-cloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
[LICENSE]: https://github.com/GoogleCloudPlatform/google-cloud-java/blob/master/LICENSE
[cloud-platform]: https://cloud.google.com/
-[cloud-datastore]: https://cloud.google.com/datastore/docs
-[cloud-datastore-docs]: https://cloud.google.com/datastore/docs
-[cloud-datastore-activation]: https://cloud.google.com/datastore/docs/activate
-[datastore-api]: https://googlecloudplatform.github.io/google-cloud-java/apidocs/index.html?com/google/cloud/datastore/package-summary.html
-
-[cloud-pubsub]: https://cloud.google.com/pubsub/
-[cloud-pubsub-docs]: https://cloud.google.com/pubsub/docs
-
-[cloud-storage]: https://cloud.google.com/storage/
-[cloud-storage-docs]: https://cloud.google.com/storage/docs/overview
-[cloud-storage-create-bucket]: https://cloud.google.com/storage/docs/cloud-console#_creatingbuckets
-[storage-api]: https://googlecloudplatform.github.io/google-cloud-java/apidocs/index.html?com/google/cloud/storage/package-summary.html