Sync changes from upstream repository

Hubot · Hubot · commit 8d7cf0f8a86f · 2015-06-16T19:49:03.000Z
diff --git a/content/guides/managing-deploy-keys.md b/content/guides/managing-deploy-keys.md
@@ -65,11 +65,11 @@ A deploy key is an SSH key that is stored on your server and grants access to a
 
 * Anyone with access to the repository and server has the ability to deploy the project.
 * Users don't have to change their local SSH settings.
+* Deploy keys can read and write by default, but can be made read-only.
 
 #### Cons
 
 * Deploy keys only grant access to a single repository. More complex projects may have many repositories to pull to the same server.
-* Deploy keys always provide full read/write access to a repository.
 * Deploy keys are usually not protected by a passphrase, making the key easily accessible if the server is compromised.
 
 #### Setup
diff --git a/content/v3/repos/keys.md b/content/v3/repos/keys.md
@@ -29,9 +29,19 @@ title: Deploy Keys | GitHub API
 
     POST /repos/:owner/:repo/keys
 
-### Input
+### Parameters
 
-<%= json :title => "octocat@octomac", :key => "ssh-rsa AAA..." %>
+Name | Type | Description
+-----|------|-------------
+`title`|`string`|A name for the key.
+`key`|`string`|The contents of the key.
+`read_only`|`boolean`|If `true`, the key will only be able to read repository contents. Otherwise, the key will be able to read and write.
+
+#### Example
+
+Here's how you can create a read-only deploy key:
+
+<%= json :title => "octocat@octomac", :key => "ssh-rsa AAA...", :read_only => true %>
 
 ### Response
 
diff --git a/lib/resources.rb b/lib/resources.rb
@@ -217,13 +217,15 @@ def fetch_content(key)
       "url"        => "https://api.github.com/user/keys/1",
       "title"      => "octocat@octomac",
       "verified"   => true,
-      "created_at" => "2014-12-10T15:53:42Z"
+      "created_at" => "2014-12-10T15:53:42Z",
+      "read_only"  => true
 
     DEPLOY_KEY ||= SIMPLE_PUBLIC_KEY.merge \
       "url"        => "https://api.github.com/repos/octocat/Hello-World/keys/1",
       "title"      => "octocat@octomac",
       "verified"   => true,
-      "created_at" => "2014-12-10T15:53:42Z"
+      "created_at" => "2014-12-10T15:53:42Z",
+      "read_only"  => true
 
     SIMPLE_REPO ||= {
       "id"               => 1296269,
