diff --git a/cloud-ts-url-shortener-cache-http/cache.ts b/cloud-ts-url-shortener-cache-http/cache.ts
index daa21de51..1f14c8c7f 100644
--- a/cloud-ts-url-shortener-cache-http/cache.ts
+++ b/cloud-ts-url-shortener-cache-http/cache.ts
@@ -1,4 +1,10 @@
-// Copyright 2016-2017, Pulumi Corporation.  All rights reserved.
+// Copyright 2016-2018, Pulumi Corporation.  All rights reserved.
+
+// Note: @pulumi/cloud is a preview package demonstrating how to create cross-cloud Pulumi
+// components. If you are targeting a specific cloud like AWS, Azure, or GCP, we recommend you use
+// platform-specific packages like @pulumi/aws, @pulumi/azure or @pulumi/gcp. These packages give
+// you full access to the breadth of the platform's capabilities and comes with many abstractions to
+// make developing against that platform easier.
 
 import * as pulumi from "@pulumi/pulumi";
 import * as cloud from "@pulumi/cloud";
diff --git a/cloud-ts-url-shortener-cache-http/index.ts b/cloud-ts-url-shortener-cache-http/index.ts
index 5e754b2dd..e83b675d3 100644
--- a/cloud-ts-url-shortener-cache-http/index.ts
+++ b/cloud-ts-url-shortener-cache-http/index.ts
@@ -1,5 +1,11 @@
 // Copyright 2016-2018, Pulumi Corporation.  All rights reserved.
 
+// Note: @pulumi/cloud is a preview package demonstrating how to create cross-cloud Pulumi
+// components. If you are targeting a specific cloud like AWS, Azure, or GCP, we recommend you use
+// platform-specific packages like @pulumi/aws, @pulumi/azure or @pulumi/gcp. These packages give
+// you full access to the breadth of the platform's capabilities and comes with many abstractions to
+// make developing against that platform easier.
+
 import * as pulumi from "@pulumi/pulumi";
 import * as cloud from "@pulumi/cloud";
 import * as cache from "./cache";
diff --git a/cloud-ts-url-shortener-cache/cache.ts b/cloud-ts-url-shortener-cache/cache.ts
index 1cfdc9920..0eba6c3fe 100644
--- a/cloud-ts-url-shortener-cache/cache.ts
+++ b/cloud-ts-url-shortener-cache/cache.ts
@@ -1,5 +1,11 @@
 // Copyright 2016-2017, Pulumi Corporation.  All rights reserved.
 
+// Note: @pulumi/cloud is a preview package demonstrating how to create cross-cloud Pulumi
+// components. If you are targeting a specific cloud like AWS, Azure, or GCP, we recommend you use
+// platform-specific packages like @pulumi/aws, @pulumi/azure or @pulumi/gcp. These packages give
+// you full access to the breadth of the platform's capabilities and comes with many abstractions to
+// make developing against that platform easier.
+
 import * as cloud from "@pulumi/cloud";
 import * as config from "./config";
 
diff --git a/cloud-ts-url-shortener-cache/index.ts b/cloud-ts-url-shortener-cache/index.ts
index 2c799f4ee..d11e131de 100644
--- a/cloud-ts-url-shortener-cache/index.ts
+++ b/cloud-ts-url-shortener-cache/index.ts
@@ -1,5 +1,11 @@
 // Copyright 2016-2018, Pulumi Corporation.  All rights reserved.
 
+// Note: @pulumi/cloud is a preview package demonstrating how to create cross-cloud Pulumi
+// components. If you are targeting a specific cloud like AWS, Azure, or GCP, we recommend you use
+// platform-specific packages like @pulumi/aws, @pulumi/azure or @pulumi/gcp. These packages give
+// you full access to the breadth of the platform's capabilities and comes with many abstractions to
+// make developing against that platform easier.
+
 import * as pulumi from "@pulumi/pulumi";
 import * as cloud from "@pulumi/cloud";
 import * as cache from "./cache";
@@ -8,7 +14,7 @@ import * as cache from "./cache";
 let endpoint = new cloud.HttpEndpoint("urlshortener");
 
 // Create a table `urls`, with `name` as primary key.
-let urlTable = new cloud.Table("urls", "name"); 
+let urlTable = new cloud.Table("urls", "name");
 
 // Create a cache of frequently accessed urls.
 let urlCache = new cache.Cache("urlcache");
diff --git a/cloud-ts-url-shortener/index.ts b/cloud-ts-url-shortener/index.ts
index 04a5b82ad..8f608e119 100644
--- a/cloud-ts-url-shortener/index.ts
+++ b/cloud-ts-url-shortener/index.ts
@@ -1,5 +1,11 @@
 // Copyright 2016-2018, Pulumi Corporation.  All rights reserved.
 
+// Note: @pulumi/cloud is a preview package demonstrating how to create cross-cloud Pulumi
+// components. If you are targeting a specific cloud like AWS, Azure, or GCP, we recommend you use
+// platform-specific packages like @pulumi/aws, @pulumi/azure or @pulumi/gcp. These packages give
+// you full access to the breadth of the platform's capabilities and comes with many abstractions to
+// make developing against that platform easier.
+
 import * as cloud from "@pulumi/cloud-aws";
 import { Output } from "@pulumi/pulumi"; // for output property
 
diff --git a/cloud-ts-voting-app/index.ts b/cloud-ts-voting-app/index.ts
index 80bd70ec3..57b99cf89 100644
--- a/cloud-ts-voting-app/index.ts
+++ b/cloud-ts-voting-app/index.ts
@@ -1,5 +1,11 @@
 // Copyright 2017, Pulumi Corporation.  All rights reserved.
 
+// Note: @pulumi/cloud is a preview package demonstrating how to create cross-cloud Pulumi
+// components. If you are targeting a specific cloud like AWS, Azure, or GCP, we recommend you use
+// platform-specific packages like @pulumi/aws, @pulumi/azure or @pulumi/gcp. These packages give
+// you full access to the breadth of the platform's capabilities and comes with many abstractions to
+// make developing against that platform easier.
+
 import * as pulumi from "@pulumi/pulumi";
 import * as cloud from "@pulumi/cloud";