Move the existing sample into a compute/ subdirectory and update README

CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# How to become a contributor and submit your own code
+
+## Contributor License Agreements
+
+We'd love to accept your patches! Before we can take them, we
+have to jump a couple of legal hurdles.
+
+Please fill out either the individual or corporate Contributor License Agreement
+(CLA).
+
+  * If you are an individual writing original source code and you're sure you
+    own the intellectual property, then you'll need to sign an [individual CLA]
+    (https://developers.google.com/open-source/cla/individual).
+  * If you work for a company that wants to allow you to contribute your work,
+    then you'll need to sign a [corporate CLA]
+    (https://developers.google.com/open-source/cla/corporate).
+
+Follow either of the two links above to access the appropriate CLA and
+instructions for how to sign and return it. Once we receive it, we'll be able to
+accept your pull requests.
+
+## Contributing A Patch
+
+1. Submit an issue describing your proposed change to the repo in question.
+1. The repo owner will respond to your issue promptly.
+1. If your proposed change is accepted, and you haven't already done so, sign a
+   Contributor License Agreement (see details above).
+1. Fork the desired repo, develop and test your code changes.
+1. Ensure that your code adheres to the existing style in the sample to which
+   you are contributing. Refer to the
+   [Google Cloud Platform Samples Style Guide]
+   (https://github.com/GoogleCloudPlatform/Template/wiki/style.html) for the
+   recommended coding standards for this organization.
+1. Ensure that your code has an appropriate set of unit tests which all pass.
+1. Submit a pull request.

README.md

@@ -1,45 +1,15 @@
-# Google Compute Engine PHP Sample Application
+## PHP Docs Samples
 
-## Description
-This is a simple web-based example of calling the Google Compute Engine API
-in PHP.
+A collection of samples that demonstrate how to call Google Cloud services from PHP.
 
-## Prerequisites:
-Please make sure that all of the following is installed before trying to run
-the sample application.
+See our other [Google Cloud Platform github
+repos](https://github.com/GoogleCloudPlatform) for sample applications and
+scaffolding for other frameworks and use cases.
 
-- PHP 5.2.x or higher [http://www.php.net/]
-- PHP Curl extension [http://www.php.net/manual/en/intro.curl.php]
-- PHP JSON extension [http://php.net/manual/en/book.json.php]
-- The google-api-php-client library checked out locally
-  [https://code.google.com/p/google-api-php-client/] 
+## Contributing changes
 
-## Setup Authentication
-NOTE: This README assumes that you have enabled access to the Google Compute
-Engine API via the Google API Console page.
+* See [CONTRIBUTING.md](CONTRIBUTING.md)
 
-1) Visit https://code.google.com/apis/console/?api=compute to register your
-application.
-- Click on "API Access" in the left column
-- Click the button labeled "Create an OAuth2 client ID..." if you have not
-generated any client IDs, or "Create another client ID..." if you have
-- Give your application a name and click "Next"
-- Select "Web Application" as the "Application type"
-- Click "Create client ID"
-- Click "Edit settings..." for your new client ID
-- Under the redirect URI, enter the location of your application
-- Click "Update"
-- Click on "Overview" in the left column and note the Project ID
+## Licensing
 
-2) Update app.php with the redirect uri, consumer key, secret, and Project ID
-obtained in step 1.
-- Update 'YOUR_CLIENT_ID' with your oauth2 client id.
-- Update 'YOUR_CLIENT_SECRET' with your oauth2 client secret.
-- Update 'YOUR_REDIRECT_URI' with the fully qualified
-redirect URI.
-- Update 'YOUR_GOOGLE_COMPUTE_ENGINE_PROJECT' with your Project ID from the 
-API Console.
-
-## Running the Sample Application
-3) Load app.php on your web server, and visit the appropriate website in
-your web browser.
+* See [LICENSE](LICENSE)

compute/README.md

@@ -0,0 +1,45 @@
+# Google Compute Engine PHP Sample Application
+
+## Description
+This is a simple web-based example of calling the Google Compute Engine API
+in PHP.
+
+## Prerequisites:
+Please make sure that all of the following is installed before trying to run
+the sample application.
+
+- PHP 5.2.x or higher [http://www.php.net/]
+- PHP Curl extension [http://www.php.net/manual/en/intro.curl.php]
+- PHP JSON extension [http://php.net/manual/en/book.json.php]
+- The google-api-php-client library checked out locally
+  [https://code.google.com/p/google-api-php-client/] 
+
+## Setup Authentication
+NOTE: This README assumes that you have enabled access to the Google Compute
+Engine API via the Google API Console page.
+
+1) Visit https://code.google.com/apis/console/?api=compute to register your
+application.
+- Click on "API Access" in the left column
+- Click the button labeled "Create an OAuth2 client ID..." if you have not
+generated any client IDs, or "Create another client ID..." if you have
+- Give your application a name and click "Next"
+- Select "Web Application" as the "Application type"
+- Click "Create client ID"
+- Click "Edit settings..." for your new client ID
+- Under the redirect URI, enter the location of your application
+- Click "Update"
+- Click on "Overview" in the left column and note the Project ID
+
+2) Update app.php with the redirect uri, consumer key, secret, and Project ID
+obtained in step 1.
+- Update 'YOUR_CLIENT_ID' with your oauth2 client id.
+- Update 'YOUR_CLIENT_SECRET' with your oauth2 client secret.
+- Update 'YOUR_REDIRECT_URI' with the fully qualified
+redirect URI.
+- Update 'YOUR_GOOGLE_COMPUTE_ENGINE_PROJECT' with your Project ID from the 
+API Console.
+
+## Running the Sample Application
+3) Load app.php on your web server, and visit the appropriate website in
+your web browser.