{"action":"created","comment":{"url":"https://api.github.com/repos/circleci/circleci-docs/pulls/comments/229938239","pull_request_review_id":170555383,"id":229938239,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIyOTkzODIzOQ==","diff_hunk":"@@ -0,0 +1,332 @@\n+---\n+layout: classic-docs\n+title: \"Creating Orbs\"\n+short-title: \"Creating Orbs\"\n+description: \"Starting point for Creating CircleCI Orbs\"\n+categories: [getting-started]\n+order: 1\n+---\n+\n+Orbs are reusable packages of CircleCI configuration that you may share across projects, enabling you to create encapsulated, parameterized commands, jobs, and executors that can be used across multiple projects.\n+\n+This section describes how you can:\n+\n+* Use an existing orb in your configuration\n+* Import an orb\n+* Create an inline orb in your `config.yml` file\n+* Create and publish an orb in the registry\n+\n+Orbs are made available for use in a configuration through the orbs key in the top level of your config.yml.\n+\n+## Using Existing Orbs\n+\n+CircleCI has made available a number of certified and 3rd party orbs that you may use in your configuration to reduce the time needed to get up and running using orbs in your configuration. By using CircleCI certified orbs, or 3rd-party orbs developed by CircleCI partners, you can be confident that these orbs have been developed and tested to ensure they work with the CircleCI platform.\n+\n+### Certified orbs vs. 3rd party Orbs\n+\n+Certified orbs are those that CircleCI has built or has reviewed and approved as part of the features of the CircleCI platform. Any project may use certified orbs in configuration version 2.1 and higher.\n+\n+3rd party orbs are those published by our customers and other members of our community. For you to publish orbs or for your projects to use 3rd party orbs, your organization must opt-in under SECURITY within the Organization Settings page under the section \"Orb Security Settings\" where an organization administrator must agree to the terms for using 3rd-party software.\n+\n+<aside class=\"notice\">\n+This setting can only be toggled by organization administrators.\n+</aside>\n+\n+### Orb reference format\n+\n+Orb references have the following format shown below:\n+\n+```\n+[namespace]/[orb]@[version]\n+```\n+\n+### Semantic Versioning in Orbs\n+\n+Orbs are published with the standard 3-number semantic versioning system:\n+\n+* major\n+* minor\n+* patch\n+\n+Orb authors need to adhere to semantic versioning. Within ```config.yml```, you may specify wildcard version ranges to resolve orbs. You may also use the special string ```volatile``` to pull in whatever the highest version number is at time your build runs.\n+\n+For example:\n+\n+* when ```mynamespace/some-orb@8.2.0``` exists, and ```mynamespace/some-orb@8.1.24``` and ```mynamespace/some-orb@8.0.56``` are published after 8.2.0, ```volatile``` will still refer to ```mynamespace/some-orb@8.2.0``` as the highest semantic version.\n+\n+Examples of orb version declarations and their meaning:\n+\n+1. ```circleci/python@volatile``` - use the latest version of the Python orb in the registry at the time a build is triggered.\n+2. ```circleci/python@2``` - use the latest version of version 2.x.y of the Python orb .\n+3. ```circleci/python@2.4``` - use the latest version of version 2.4.x of the Python orb .\n+4. ```circleci/python@3.1.4``` - use exactly version 3.1.4 of the Python orb.\n+\n+#### Using Development Versions\n+\n+While all production orbs must be published securely by organization administrators, development orbs allow your team much broader latitude.\n+\n+A development version must be referenced entirely, such as: ```mynamespace/myorb@dev:mybranch.```; whereas production orbs allow wildcard semantic version references. Note that there are no shorthand conveniences for development versions.\n+\n+<aside class=\"notice\">\n+Dev versions are mutable and expire: their contents can change, and they are subject to deletion after 90 days; therefore, it is strongly recommended you do not rely on a development versions in any production software, and use them only while actively developing your orb.\n+</aside>\n+\n+## Importing an Orb\n+\n+Importing a set of existing orbs is a simple process that only requires you to provide the following instruction in your configuration. In the example below, you can see how to import a CircleCI Slack and Heroku orb:\n+\n+```orbs:\n+  slack: circleci/slack@0.1.0\n+  heroku: circleci/heroku@volatile\n+```\n+\n+### Designing Orbs\n+\n+When designing your own orbs, make sure your orbs meet the following requirements:\n+\n+* Orbs should always use 'description'. - Be sure to explain usage, assumptions, and any tricks in the ```description``` key under jobs, commands, executors, and parameters.\n+* Match commands to executors - If you are providing commands, try to provide one or more executors in which they will run.\n+* Use concise naming for your Orb - Remember that use of your commands and jobs is always contextual to your Orb, so you can use general names like \"run-tests\" in most cases.\n+* Required vs. Optional Parameters - Provide sound default values of parameters whenever possible.\n+* Avoid Job-only Orbs - Job-only Orbs are inflexible. While these Orbs are sometimes appropriate, it can be frustrating for users to not be able to use the commands in their own jobs. Pre and post steps when invoking jobs are a workaround for users.\n+* Parameter `steps` are powerful - Wrapping steps provided by the user allows you to encapsulate and sugar things like caching strategies and other more complex tasks, providing a lot of value to users.\n+\n+When developing your own orb, you may find it useful to write an inline orb. The section below describes how you can write your own inline orb.\n+\n+## Creating Inline Orbs\n+\n+Inline orbs can be handy during development of an orb or as a convenience for name-spacing jobs and commands in lengthy configurations, particularly if you later intend to share the orb with others.\n+\n+To write inline orbs, you need to place the orb elements under that orb's key in the ```orbs``` declaration in the configuration. For example, if you want to import one orb and then author inline for another, the orb might look like the example shown below:\n+\n+```\n+orbs:\n+  codecov: circleci/codecov-clojure@0.0.4\n+  my-orb:\n+    executors:\n+      default:\n+        docker:\n+          - image: circleci/ruby:1.4.2\n+    commands:\n+      dospecialthings:\n+        steps:\n+          - run: echo \"We will now do special things\"\n+    jobs:\n+      myjob:\n+        executor: default\n+        steps:\n+          - dospecialthings\n+          - codecov/upload:\n+              path: ~/tmp/results.xml\n+\n+version: 2.1\n+workflows:\n+  main:\n+    jobs:\n+      - my-orb/myjob\n+```\n+\n+<aside class=\"notice\">\n+In the example above, note that the contents of ```my-orb``` are resolved as an inline orb because the contents of ```my-orb``` are a map; whereas the contents of ```codecov``` are a scalar value, and thus assumed to be an orb URI.\n+</aside>\n+\n+### Example Template\n+\n+When you want to author an orb, you may wish to use this example template to quickly and easily create a new orb with all of the required concepts. This example includes each of the three top-level concepts of orbs. While any orb can be equally expressed as an inline orb definition, it will generally be simpler to iterate on an inline orb and use ```circleci config process .circleci/config.yml``` to check whether your orb usage matches your expectation.\n+```\n+version: 2.1\n+orbs:\n+  inline_example:\n+    jobs:\n+      my_inline_job:\n+        parameters:\n+          greeting_name:\n+            type: string\n+            default: olleh\n+        executor: my_inline_executor\n+        steps:\n+          - my_inline_command:\n+              name: <<parameters.greeting_name>>\n+    commands:\n+      my_inline_command:\n+        parameters:\n+          name:\n+            type: string\n+        steps:\n+          - run: echo \"hello <<parameters.name>>, from the inline command\"\n+    executors:\n+      my_inline_executor:\n+        parameters:\n+          version:\n+            type: string\n+            default: \"2.4\"\n+        docker:\n+          - image: circleci/ruby:<<parameters.version>>\n+\n+workflows:\n+  build-test-deploy:\n+    jobs:\n+      - inline_example/my_inline_job:\n+          name: build\n+      - inline_example/my_inline_job:\n+          name: build2\n+          greeting_name: world\n+```\n+\n+## Publishing an Orb\n+\n+This section covers the tooling and flow of authoring and publishing your own orbs to the orb registry.\n+\n+Orbs may be authored inline in your config.yml file or authored separately and then published to to the orb registry for reuse across projects.\n+\n+[WARNING] Orbs are always world-readable. All published orbs can be read and used by anyone. They are not limited to just the members of your organization. In general, CircleCI strongly recommends that you do not put secrets or other sensitive variables into your configuration. Instead, use contexts or project environment variables and reference the names of those environment variables in your orbs.\n+\n+### Prerequisites\n+\n+Before publishing an orb, you will need to first opt-in to the new 3rd-Party Software terms and turn on orb publishing for your organization.\n+\n+<aside class=\"notice\">\n+Only an organization administrator can opt-in to the 3rd party Software terms. The organization admin will need to navigate to the organization Settings tab and complete the form on the Security page.\n+</aside>\n+\n+### Orb Publishing Concepts\n+\n+The sections below describe important concepts that you should understand before publishing an orb.\n+\n+#### Orb Registry\n+\n+Each installation of CircleCI has a single orb registry. The registry on circleci.com serves as the master source for all certified namespaces and orbs and is the only orb registry that users of circleci.com can use.\n+\n+When orb features come to the server installation of CircleCI, each installation will have its own registry that operators can control.\n+\n+<aside class=\"notice\">\n+Currently, orb features are not yet supported on server installations.\n+</aside>\n+\n+#### Namespaces\n+\n+Namespaces are used to organize a set of orbs. Each namespace has a unique and immutable name within the registry, and each orb in a namespace has a unique name. For example, the orb ```circleci/rails``` means the rails orb in the ```circleci``` namespace may coexist in the registry with an orb called ```somenamespace/rails``` because they are in separate namespaces.\n+\n+Namespaces are owned by organizations. Only organization administrators can create namespaces.\n+\n+Organizations are, by default, limited to claiming only one namespace. This policy is designed to limit name-squatting and namespace noise. If you require more than one namespace please contact your account team at CircleCI.\n+\n+#### Development vs. Production Orbs\n+\n+Orb versions may be added to the registry either as development versions or production versions. Production versions are always a semantic version like 1.5.3; whereas development versions can be tagged with a string and are always prefixed with dev:.\n+\n+##### Development and Production Orb Security Profiles\n+\n+* Only organization administrators can publish production orbs.\n+\n+* Any member of an organization can publish dev orbs in namespaces.\n+\n+##### Development and Production Orb Retention and Mutability Characteristics\n+\n+* Dev orbs are mutable and expire. Anyone can overwrite any development orb who is a member of the organization that owns the namespace in which that orb is published.\n+\n+* Production orbs are immutable and long-lived. Once you publish a production orb at a given semantic version you may not change the content of that orb at that version. To change the content of a production orb you must publish a new version. CircleCI generally recommends using the ```orb publish increment``` and/or the ```orb publish promote``` commands in the ```circleci``` CLI when publishing orbs to production.\n+\n+##### Development and Production Orbs Versioning Semantics\n+\n+Development orbs are tagged with the format ```dev:<< your-string >>```. Production orbs are always published using the semantic versioning (\"semver\") scheme.\n+\n+In development orbs, the string label given by the user has the following restrictions:\n+\n+* Up to 1023 non-whitespace characters\n+\n+Examples of valid development orb tags:\n+\n+* Valid:\n+  \"dev:mybranch\"\n+  \"dev:2018_09_01\"\n+  \"dev:1.2.3-rc1\"\n+  \"dev:myinitials/mybranch\"\n+  \"dev:myVERYIMPORTANTbranch\"\n+\n+* Invalid\n+  \"dev: 1\" (No spaces allowed)\n+  \"1.2.3-rc1\" (No leading \"dev:\")\n+\n+In production orbs you must use the form ```X.Y.Z``` where ```X``` is a \"major\" version, ```Y``` is a \"minor\" version, and ```Z``` is a \"patch\" version. For example, 2.4.0 implies the major version 2, minor version 4, and the patch version of 0.\n+\n+While not strictly enforced, CircleCI recommends when versioning your production orbs you use the standard semantic versioning convention for deciding what major, minor, and patch should mean semantically:\n+\n+* MAJOR: when you make incompatible API changes\n+* MINOR: when you add functionality in a backwards-compatible manner\n+* PATCH: when you make backwards-compatible bug fixes\n+\n+#### Using Orbs in Orbs and Register-Time Resolution\n+\n+You may use an ```orbs``` stanza inside an orb, providing a way to pull in other orbs' elements into your orb. The scoping rules are the same as orbs in configuration, and you declare inline orbs in an orb.\n+\n+<aside class=\"notice\">\n+Because production orb releases are immutable, the system will resolve all orb dependencies at the time you register your orb rather than the time you run your build (eager resolution).\n+\n+For example, if you choose to publish orb ```foo/bar``` at version ```1.2.3```, and that orb you are publishing has, internally, an ```orbs``` stanza that imports another orb referenced as ```biz/baz@volatile```, the latest version at the time you want to perform this action is ```2.1.0```. At the time you register ```foo/bar@1.2.3``` the system will resolve ```biz/baz@volatile``` as the latest version and include its elements directly into the packaged version of ```foo/bar@1.2.3```.\n+\n+Now, if afterwards, ```biz/baz``` receives a new release that is now ```3.0.0```, anyone using ```foo/bar@1.2.3``` will not see the change in ```biz/baz@3.0.0``` until ```foo/bar``` is published at a higher version.\n+</aside>\n+\n+#### Deleting Production Orbs\n+\n+In general, CircleCI prefers to never delete production orbs that were published as \"Open\" because it harms the reliability of the orb registry as a source of configuration and the trust of all orb users.\n+\n+If the case arises where you need to delete an orb for emergency reasons, please contact CircleCI (**Note:** If you are deleting because of a security concern, you must practice responsible disclosure: https://circleci.com/security/).\n+\n+#### Using the CLI to Create and Publish Orbs\n+\n+The ```circleci``` CLI has several handy commands for managing your orb publishing pipeline. The simplest way to learn the CLI is to install it and run ```circleci help```. Listed below are some of the most pertinent commands for publishing orbs:\n+\n+* ```circleci namespace create <name> <vcs-type> <org-name> [flags]```\n+\n+* ```circleci orb create <namespace>/<orb> [flags]```\n+\n+* ```circleci orb validate <path> [flags]```\n+\n+* ```circleci orb publish <path> <namespace>/<orb>@<version> [flags]```\n+\n+* ```circleci orb publish increment <path> <namespace>/<orb> <segment> [flags]```\n+\n+* ```circleci orb publish promote <namespace>/<orb>@<version> <segment> [flags]```\n+\n+For a full list of help commands inside the CLI, visit https://circleci-public.github.io/circleci-cli/circleci_orb.html [update link when the link to the docs site is active]\n+\n+### Orb Publishing Workflow\n+\n+To publish an orb, follow the steps listed below.\n+\n+1. Claim a namespace (assuming you don't yet have one), e.g.;","path":"jekyll/_cci2/creating-orbs.md","position":299,"original_position":299,"commit_id":"25302fd98277b1566a543d94df3222d1d50e0655","original_commit_id":"e744d5e9d2fadba3c55c0b03c7805543eb2791af","user":{"login":"hannahhenderson","id":18273771,"node_id":"MDQ6VXNlcjE4MjczNzcx","avatar_url":"https://avatars3.githubusercontent.com/u/18273771?v=4","gravatar_id":"","url":"https://api.github.com/users/hannahhenderson","html_url":"https://github.com/hannahhenderson","followers_url":"https://api.github.com/users/hannahhenderson/followers","following_url":"https://api.github.com/users/hannahhenderson/following{/other_user}","gists_url":"https://api.github.com/users/hannahhenderson/gists{/gist_id}","starred_url":"https://api.github.com/users/hannahhenderson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hannahhenderson/subscriptions","organizations_url":"https://api.github.com/users/hannahhenderson/orgs","repos_url":"https://api.github.com/users/hannahhenderson/repos","events_url":"https://api.github.com/users/hannahhenderson/events{/privacy}","received_events_url":"https://api.github.com/users/hannahhenderson/received_events","type":"User","site_admin":false},"body":"0. Be an org admin.","created_at":"2018-11-01T04:40:56Z","updated_at":"2018-11-01T04:40:56Z","html_url":"https://github.com/circleci/circleci-docs/pull/2843#discussion_r229938239","pull_request_url":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843","author_association":"NONE","_links":{"self":{"href":"https://api.github.com/repos/circleci/circleci-docs/pulls/comments/229938239"},"html":{"href":"https://github.com/circleci/circleci-docs/pull/2843#discussion_r229938239"},"pull_request":{"href":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843"}}},"pull_request":{"url":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843","id":225582057,"node_id":"MDExOlB1bGxSZXF1ZXN0MjI1NTgyMDU3","html_url":"https://github.com/circleci/circleci-docs/pull/2843","diff_url":"https://github.com/circleci/circleci-docs/pull/2843.diff","patch_url":"https://github.com/circleci/circleci-docs/pull/2843.patch","issue_url":"https://api.github.com/repos/circleci/circleci-docs/issues/2843","number":2843,"state":"open","locked":false,"title":"Orbs ov usage faq draft","user":{"login":"michelle-luna","id":25971961,"node_id":"MDQ6VXNlcjI1OTcxOTYx","avatar_url":"https://avatars2.githubusercontent.com/u/25971961?v=4","gravatar_id":"","url":"https://api.github.com/users/michelle-luna","html_url":"https://github.com/michelle-luna","followers_url":"https://api.github.com/users/michelle-luna/followers","following_url":"https://api.github.com/users/michelle-luna/following{/other_user}","gists_url":"https://api.github.com/users/michelle-luna/gists{/gist_id}","starred_url":"https://api.github.com/users/michelle-luna/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/michelle-luna/subscriptions","organizations_url":"https://api.github.com/users/michelle-luna/orgs","repos_url":"https://api.github.com/users/michelle-luna/repos","events_url":"https://api.github.com/users/michelle-luna/events{/privacy}","received_events_url":"https://api.github.com/users/michelle-luna/received_events","type":"User","site_admin":false},"body":"# Description\r\nfirst set of new and updated files for orbs, this is just for using orbs, authoring orbs docs will be up for review Monday 10.29.\r\n\r\n# Reasons\r\nneed to migrate content from preview repo to official docs","created_at":"2018-10-24T23:34:56Z","updated_at":"2018-11-01T04:40:56Z","closed_at":null,"merged_at":null,"merge_commit_sha":"09866ce40848ef4e3ab732cb0c235c59c917167c","assignee":null,"assignees":[],"requested_reviewers":[{"login":"eddiewebb","id":5262154,"node_id":"MDQ6VXNlcjUyNjIxNTQ=","avatar_url":"https://avatars0.githubusercontent.com/u/5262154?v=4","gravatar_id":"","url":"https://api.github.com/users/eddiewebb","html_url":"https://github.com/eddiewebb","followers_url":"https://api.github.com/users/eddiewebb/followers","following_url":"https://api.github.com/users/eddiewebb/following{/other_user}","gists_url":"https://api.github.com/users/eddiewebb/gists{/gist_id}","starred_url":"https://api.github.com/users/eddiewebb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eddiewebb/subscriptions","organizations_url":"https://api.github.com/users/eddiewebb/orgs","repos_url":"https://api.github.com/users/eddiewebb/repos","events_url":"https://api.github.com/users/eddiewebb/events{/privacy}","received_events_url":"https://api.github.com/users/eddiewebb/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843/commits","review_comments_url":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843/comments","review_comment_url":"https://api.github.com/repos/circleci/circleci-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/circleci/circleci-docs/issues/2843/comments","statuses_url":"https://api.github.com/repos/circleci/circleci-docs/statuses/25302fd98277b1566a543d94df3222d1d50e0655","head":{"label":"circleci:orbs-ov-usage-faq-draft","ref":"orbs-ov-usage-faq-draft","sha":"25302fd98277b1566a543d94df3222d1d50e0655","user":{"login":"circleci","id":1231870,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEyMzE4NzA=","avatar_url":"https://avatars2.githubusercontent.com/u/1231870?v=4","gravatar_id":"","url":"https://api.github.com/users/circleci","html_url":"https://github.com/circleci","followers_url":"https://api.github.com/users/circleci/followers","following_url":"https://api.github.com/users/circleci/following{/other_user}","gists_url":"https://api.github.com/users/circleci/gists{/gist_id}","starred_url":"https://api.github.com/users/circleci/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/circleci/subscriptions","organizations_url":"https://api.github.com/users/circleci/orgs","repos_url":"https://api.github.com/users/circleci/repos","events_url":"https://api.github.com/users/circleci/events{/privacy}","received_events_url":"https://api.github.com/users/circleci/received_events","type":"Organization","site_admin":false},"repo":{"id":48750547,"node_id":"MDEwOlJlcG9zaXRvcnk0ODc1MDU0Nw==","name":"circleci-docs","full_name":"circleci/circleci-docs","private":false,"owner":{"login":"circleci","id":1231870,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEyMzE4NzA=","avatar_url":"https://avatars2.githubusercontent.com/u/1231870?v=4","gravatar_id":"","url":"https://api.github.com/users/circleci","html_url":"https://github.com/circleci","followers_url":"https://api.github.com/users/circleci/followers","following_url":"https://api.github.com/users/circleci/following{/other_user}","gists_url":"https://api.github.com/users/circleci/gists{/gist_id}","starred_url":"https://api.github.com/users/circleci/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/circleci/subscriptions","organizations_url":"https://api.github.com/users/circleci/orgs","repos_url":"https://api.github.com/users/circleci/repos","events_url":"https://api.github.com/users/circleci/events{/privacy}","received_events_url":"https://api.github.com/users/circleci/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/circleci/circleci-docs","description":"Documentation for CircleCI.","fork":false,"url":"https://api.github.com/repos/circleci/circleci-docs","forks_url":"https://api.github.com/repos/circleci/circleci-docs/forks","keys_url":"https://api.github.com/repos/circleci/circleci-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/circleci/circleci-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/circleci/circleci-docs/teams","hooks_url":"https://api.github.com/repos/circleci/circleci-docs/hooks","issue_events_url":"https://api.github.com/repos/circleci/circleci-docs/issues/events{/number}","events_url":"https://api.github.com/repos/circleci/circleci-docs/events","assignees_url":"https://api.github.com/repos/circleci/circleci-docs/assignees{/user}","branches_url":"https://api.github.com/repos/circleci/circleci-docs/branches{/branch}","tags_url":"https://api.github.com/repos/circleci/circleci-docs/tags","blobs_url":"https://api.github.com/repos/circleci/circleci-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/circleci/circleci-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/circleci/circleci-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/circleci/circleci-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/circleci/circleci-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/circleci/circleci-docs/languages","stargazers_url":"https://api.github.com/repos/circleci/circleci-docs/stargazers","contributors_url":"https://api.github.com/repos/circleci/circleci-docs/contributors","subscribers_url":"https://api.github.com/repos/circleci/circleci-docs/subscribers","subscription_url":"https://api.github.com/repos/circleci/circleci-docs/subscription","commits_url":"https://api.github.com/repos/circleci/circleci-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/circleci/circleci-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/circleci/circleci-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/circleci/circleci-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/circleci/circleci-docs/contents/{+path}","compare_url":"https://api.github.com/repos/circleci/circleci-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/circleci/circleci-docs/merges","archive_url":"https://api.github.com/repos/circleci/circleci-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/circleci/circleci-docs/downloads","issues_url":"https://api.github.com/repos/circleci/circleci-docs/issues{/number}","pulls_url":"https://api.github.com/repos/circleci/circleci-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/circleci/circleci-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/circleci/circleci-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/circleci/circleci-docs/labels{/name}","releases_url":"https://api.github.com/repos/circleci/circleci-docs/releases{/id}","deployments_url":"https://api.github.com/repos/circleci/circleci-docs/deployments","created_at":"2015-12-29T14:14:27Z","updated_at":"2018-10-31T22:50:20Z","pushed_at":"2018-10-31T22:55:36Z","git_url":"git://github.com/circleci/circleci-docs.git","ssh_url":"git@github.com:circleci/circleci-docs.git","clone_url":"https://github.com/circleci/circleci-docs.git","svn_url":"https://github.com/circleci/circleci-docs","homepage":"https://circleci.com/docs/","size":25770,"stargazers_count":218,"watchers_count":218,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":501,"mirror_url":null,"archived":false,"open_issues_count":17,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":501,"open_issues":17,"watchers":218,"default_branch":"master"}},"base":{"label":"circleci:master","ref":"master","sha":"63631b2b618dc16e9f1169d82abe306b9ed2d913","user":{"login":"circleci","id":1231870,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEyMzE4NzA=","avatar_url":"https://avatars2.githubusercontent.com/u/1231870?v=4","gravatar_id":"","url":"https://api.github.com/users/circleci","html_url":"https://github.com/circleci","followers_url":"https://api.github.com/users/circleci/followers","following_url":"https://api.github.com/users/circleci/following{/other_user}","gists_url":"https://api.github.com/users/circleci/gists{/gist_id}","starred_url":"https://api.github.com/users/circleci/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/circleci/subscriptions","organizations_url":"https://api.github.com/users/circleci/orgs","repos_url":"https://api.github.com/users/circleci/repos","events_url":"https://api.github.com/users/circleci/events{/privacy}","received_events_url":"https://api.github.com/users/circleci/received_events","type":"Organization","site_admin":false},"repo":{"id":48750547,"node_id":"MDEwOlJlcG9zaXRvcnk0ODc1MDU0Nw==","name":"circleci-docs","full_name":"circleci/circleci-docs","private":false,"owner":{"login":"circleci","id":1231870,"node_id":"MDEyOk9yZ2FuaXphdGlvbjEyMzE4NzA=","avatar_url":"https://avatars2.githubusercontent.com/u/1231870?v=4","gravatar_id":"","url":"https://api.github.com/users/circleci","html_url":"https://github.com/circleci","followers_url":"https://api.github.com/users/circleci/followers","following_url":"https://api.github.com/users/circleci/following{/other_user}","gists_url":"https://api.github.com/users/circleci/gists{/gist_id}","starred_url":"https://api.github.com/users/circleci/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/circleci/subscriptions","organizations_url":"https://api.github.com/users/circleci/orgs","repos_url":"https://api.github.com/users/circleci/repos","events_url":"https://api.github.com/users/circleci/events{/privacy}","received_events_url":"https://api.github.com/users/circleci/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/circleci/circleci-docs","description":"Documentation for CircleCI.","fork":false,"url":"https://api.github.com/repos/circleci/circleci-docs","forks_url":"https://api.github.com/repos/circleci/circleci-docs/forks","keys_url":"https://api.github.com/repos/circleci/circleci-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/circleci/circleci-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/circleci/circleci-docs/teams","hooks_url":"https://api.github.com/repos/circleci/circleci-docs/hooks","issue_events_url":"https://api.github.com/repos/circleci/circleci-docs/issues/events{/number}","events_url":"https://api.github.com/repos/circleci/circleci-docs/events","assignees_url":"https://api.github.com/repos/circleci/circleci-docs/assignees{/user}","branches_url":"https://api.github.com/repos/circleci/circleci-docs/branches{/branch}","tags_url":"https://api.github.com/repos/circleci/circleci-docs/tags","blobs_url":"https://api.github.com/repos/circleci/circleci-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/circleci/circleci-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/circleci/circleci-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/circleci/circleci-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/circleci/circleci-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/circleci/circleci-docs/languages","stargazers_url":"https://api.github.com/repos/circleci/circleci-docs/stargazers","contributors_url":"https://api.github.com/repos/circleci/circleci-docs/contributors","subscribers_url":"https://api.github.com/repos/circleci/circleci-docs/subscribers","subscription_url":"https://api.github.com/repos/circleci/circleci-docs/subscription","commits_url":"https://api.github.com/repos/circleci/circleci-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/circleci/circleci-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/circleci/circleci-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/circleci/circleci-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/circleci/circleci-docs/contents/{+path}","compare_url":"https://api.github.com/repos/circleci/circleci-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/circleci/circleci-docs/merges","archive_url":"https://api.github.com/repos/circleci/circleci-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/circleci/circleci-docs/downloads","issues_url":"https://api.github.com/repos/circleci/circleci-docs/issues{/number}","pulls_url":"https://api.github.com/repos/circleci/circleci-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/circleci/circleci-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/circleci/circleci-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/circleci/circleci-docs/labels{/name}","releases_url":"https://api.github.com/repos/circleci/circleci-docs/releases{/id}","deployments_url":"https://api.github.com/repos/circleci/circleci-docs/deployments","created_at":"2015-12-29T14:14:27Z","updated_at":"2018-10-31T22:50:20Z","pushed_at":"2018-10-31T22:55:36Z","git_url":"git://github.com/circleci/circleci-docs.git","ssh_url":"git@github.com:circleci/circleci-docs.git","clone_url":"https://github.com/circleci/circleci-docs.git","svn_url":"https://github.com/circleci/circleci-docs","homepage":"https://circleci.com/docs/","size":25770,"stargazers_count":218,"watchers_count":218,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":501,"mirror_url":null,"archived":false,"open_issues_count":17,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":501,"open_issues":17,"watchers":218,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843"},"html":{"href":"https://github.com/circleci/circleci-docs/pull/2843"},"issue":{"href":"https://api.github.com/repos/circleci/circleci-docs/issues/2843"},"comments":{"href":"https://api.github.com/repos/circleci/circleci-docs/issues/2843/comments"},"review_comments":{"href":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843/comments"},"review_comment":{"href":"https://api.github.com/repos/circleci/circleci-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/circleci/circleci-docs/pulls/2843/commits"},"statuses":{"href":"https://api.github.com/repos/circleci/circleci-docs/statuses/25302fd98277b1566a543d94df3222d1d50e0655"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"hannahhenderson"}}