{"action":"created","issue":{"url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/issues/171","repository_url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers","labels_url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/issues/171/labels{/name}","comments_url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/issues/171/comments","events_url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/issues/171/events","html_url":"https://github.com/rackerlabs/docs-cloud-load-balancers/issues/171","id":175872421,"number":171,"title":"V2 - Refactor API Guide: publish and deploy updates","user":{"login":"cyrichardson","id":4238838,"avatar_url":"https://avatars.githubusercontent.com/u/4238838?v=3","gravatar_id":"","url":"https://api.github.com/users/cyrichardson","html_url":"https://github.com/cyrichardson","followers_url":"https://api.github.com/users/cyrichardson/followers","following_url":"https://api.github.com/users/cyrichardson/following{/other_user}","gists_url":"https://api.github.com/users/cyrichardson/gists{/gist_id}","starred_url":"https://api.github.com/users/cyrichardson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cyrichardson/subscriptions","organizations_url":"https://api.github.com/users/cyrichardson/orgs","repos_url":"https://api.github.com/users/cyrichardson/repos","events_url":"https://api.github.com/users/cyrichardson/events{/privacy}","received_events_url":"https://api.github.com/users/cyrichardson/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/labels/documentation%20quality","name":"documentation quality","color":"0052cc"},{"url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/labels/information%20architecture","name":"information architecture","color":"0052cc"},{"url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/labels/toolset%20development","name":"toolset development","color":"0052cc"}],"state":"open","locked":false,"assignee":{"login":"cyrichardson","id":4238838,"avatar_url":"https://avatars.githubusercontent.com/u/4238838?v=3","gravatar_id":"","url":"https://api.github.com/users/cyrichardson","html_url":"https://github.com/cyrichardson","followers_url":"https://api.github.com/users/cyrichardson/followers","following_url":"https://api.github.com/users/cyrichardson/following{/other_user}","gists_url":"https://api.github.com/users/cyrichardson/gists{/gist_id}","starred_url":"https://api.github.com/users/cyrichardson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cyrichardson/subscriptions","organizations_url":"https://api.github.com/users/cyrichardson/orgs","repos_url":"https://api.github.com/users/cyrichardson/repos","events_url":"https://api.github.com/users/cyrichardson/events{/privacy}","received_events_url":"https://api.github.com/users/cyrichardson/received_events","type":"User","site_admin":false},"assignees":[{"login":"cyrichardson","id":4238838,"avatar_url":"https://avatars.githubusercontent.com/u/4238838?v=3","gravatar_id":"","url":"https://api.github.com/users/cyrichardson","html_url":"https://github.com/cyrichardson","followers_url":"https://api.github.com/users/cyrichardson/followers","following_url":"https://api.github.com/users/cyrichardson/following{/other_user}","gists_url":"https://api.github.com/users/cyrichardson/gists{/gist_id}","starred_url":"https://api.github.com/users/cyrichardson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cyrichardson/subscriptions","organizations_url":"https://api.github.com/users/cyrichardson/orgs","repos_url":"https://api.github.com/users/cyrichardson/repos","events_url":"https://api.github.com/users/cyrichardson/events{/privacy}","received_events_url":"https://api.github.com/users/cyrichardson/received_events","type":"User","site_admin":false}],"milestone":{"url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/milestones/13","html_url":"https://github.com/rackerlabs/docs-cloud-load-balancers/milestones/Milestone%2015","labels_url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/milestones/13/labels","id":1902515,"number":13,"title":"Milestone 15","description":"","creator":{"login":"cyrichardson","id":4238838,"avatar_url":"https://avatars.githubusercontent.com/u/4238838?v=3","gravatar_id":"","url":"https://api.github.com/users/cyrichardson","html_url":"https://github.com/cyrichardson","followers_url":"https://api.github.com/users/cyrichardson/followers","following_url":"https://api.github.com/users/cyrichardson/following{/other_user}","gists_url":"https://api.github.com/users/cyrichardson/gists{/gist_id}","starred_url":"https://api.github.com/users/cyrichardson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cyrichardson/subscriptions","organizations_url":"https://api.github.com/users/cyrichardson/orgs","repos_url":"https://api.github.com/users/cyrichardson/repos","events_url":"https://api.github.com/users/cyrichardson/events{/privacy}","received_events_url":"https://api.github.com/users/cyrichardson/received_events","type":"User","site_admin":false},"open_issues":4,"closed_issues":1,"state":"open","created_at":"2016-07-25T13:48:57Z","updated_at":"2016-09-09T21:37:09Z","due_on":"2016-09-21T04:00:00Z","closed_at":null},"comments":0,"created_at":"2016-09-08T21:44:15Z","updated_at":"2016-09-12T14:32:47Z","closed_at":null,"body":"## Update the content URL for refactored API documentation\r\n\r\n- [x] Fork and clone the  [nexus-control](https://github.com/rackerlabs/nexus-control) to your local system.\r\n- [x] Remove ``developer-guide`` from the route configured for the content.\r\n      - [x] Update the [nexus-control configuration file](https://github.com/rackerlabs/nexus-control/blob/master/config/content.d/developer.rackspace.com.json) as shown in the following example:\r\n       \r\n           **Original:** ``\"/docs/cloud-load-balancers/v1/\": \"https://github.com/rackerlabs/docs-cloud-load-balancers/v1/developer-guide\",``\r\n\r\n           **Updated:**``\"/docs/cloud-load-balancers/v1/\": \"https://github.com/rackerlabs/docs-cloud-load-balancers/v1/\",\r\n        \r\n         **Notes:**\r\n \r\n          The value on the left is the path to deploy content. The value to the right of the ``:`` is the unique\r\n          content ID for the Sphinx project. The content ID must match the ``\"contentIDBase\"`` value in the\r\n          ``_deconst.json`` file in the documentation source directory. See [Configure development and production builds for Sphinx projects](https://github.com/rackerlabs/docs-rackspace/blob/master/doc/tools/publishing.rst).\r\n\r\n- [x] Update the deploy URL in the [route configuration file](https://github.com/rackerlabs/nexus-control/blob/master/config/routes.d/developer.rackspace.com.json) to match the one in the nexus-control configuration file.\r\n- [x] Create a redirect rule for the original URL.\r\n      \r\n      - [ ] Edit the [rewrites file](https://github.com/rackerlabs/nexus-control/tree/master/config/rewrites.d) to add a redirect rule for the original URL as shown in the following example:\r\n\r\n       ```\r\n          {\r\n             \"description\": \"Redirect load balancers developer-guide URL\",\r\n             \"from\": \"^\\\\/docs\\\\/cloud-load-balancers\\\\/v1\\\\/developer-guide\\\\/(.*?)\",\r\n             \"to\": \"/docs/cloud-load-balancers/v1/$1\",\r\n             \"rewrite\": false,\r\n             \"status\": 301\r\n         },\r\n      ```\r\n      - [x] Use a json linter to verify that the JSON syntax is correct.\r\n\r\n- [x] Commit the changes, and push to your fork.\r\n- [x] Submit your updates as a PR against the upstream repository. Include a link to the PR containing the refactored documentation source.\r\n- [x] After the PR is merged, verify that the content is deployed to the new URL, for example ``https:\\\\developer.rackspace.com\\docs\\<updated-path>``\r\n- [x] Verify that the redirect rule is working by clicking the Developer Guide link on the [DRC docs landing page](https://developer.rackspace.com/docs/).\r\n\r\n**Note:** Nexus-control changes take longer to deploy than content changes. You can check the [nexus-control version information](https://developer.rackspace.com/version/) to determine whether the commit has been deployed. \r\n\r\n## Update the [documentation landing page](https://github.com/rackerlabs/docs-quickstart/edit/master/index.rst)\r\nUpdate the menu so that it matches the Load Balancers v1 example shown in the following figure: \r\n![load-balancer-v1-doc-menu](https://cloud.githubusercontent.com/assets/6391769/17104681/8c4a4452-5249-11e6-8d96-f745279766c0.png)\r\n\r\n**Important:** Don't commit the landing page updates until you have verified that the content has been deployed to the new URL.\r\n\r\nSome menus might be slightly different if the product doesn't have an SDK Quickstart, or if it has additional documentation.  If you have questions about the menu content or order, open an [issue](https://github.com/rackerlabs/docs-common/issues/new). \r\n- [ ] Fork and clone the [docs-quickstart repo](https://github.com/rackerlabs/docs-quickstart) to your local system.\r\n- [ ] Find the menu for the API documentation you are updating.\r\n- [ ] Update the title list and href link targets with the information for your documentation.\r\n- [ ] Save the file. \r\n- [ ] Commit the changes and push to your fork.\r\n- [ ] Submit your updates as a PR against the upstream repository. Include a link to the PR containing the refactored documentation source.\r\n      - [ ] Check the PR builder preview to make sure the landing page renders correctly with your updates.\r\n      - [ ] Request someone to review and merge the PR."},"comment":{"url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/issues/comments/246366532","html_url":"https://github.com/rackerlabs/docs-cloud-load-balancers/issues/171#issuecomment-246366532","issue_url":"https://api.github.com/repos/rackerlabs/docs-cloud-load-balancers/issues/171","id":246366532,"user":{"login":"cyrichardson","id":4238838,"avatar_url":"https://avatars.githubusercontent.com/u/4238838?v=3","gravatar_id":"","url":"https://api.github.com/users/cyrichardson","html_url":"https://github.com/cyrichardson","followers_url":"https://api.github.com/users/cyrichardson/followers","following_url":"https://api.github.com/users/cyrichardson/following{/other_user}","gists_url":"https://api.github.com/users/cyrichardson/gists{/gist_id}","starred_url":"https://api.github.com/users/cyrichardson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cyrichardson/subscriptions","organizations_url":"https://api.github.com/users/cyrichardson/orgs","repos_url":"https://api.github.com/users/cyrichardson/repos","events_url":"https://api.github.com/users/cyrichardson/events{/privacy}","received_events_url":"https://api.github.com/users/cyrichardson/received_events","type":"User","site_admin":false},"created_at":"2016-09-12T14:32:47Z","updated_at":"2016-09-12T14:32:47Z","body":"I did add a redirect, but it really isn't needed because this doc is not on docs.rackspace.com and never will be because it is not yet published externally."}}
{"actor":{"display_login":"cyrichardson"}}