{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/71738114","id":71738114,"diff_hunk":"@@ -110,3 +110,69 @@ HTTP server also monitors the project and detects any changes. When you save a\n change to a file, the server rebuilds the HTML and refreshes your browser\n automatically. In this way you can rapidly see how changes you make will be\n rendered as HTML.\n+\n+================================\n+Adding Release Notes\n+================================","path":"README.rst","position":18,"original_position":18,"commit_id":"aa56173a5c81b02fcdcf955fe6fb1638af6c409a","original_commit_id":"aa56173a5c81b02fcdcf955fe6fb1638af6c409a","user":{"login":"srpearce","id":3493253,"avatar_url":"https://avatars.githubusercontent.com/u/3493253?v=3","gravatar_id":"","url":"https://api.github.com/users/srpearce","html_url":"https://github.com/srpearce","followers_url":"https://api.github.com/users/srpearce/followers","following_url":"https://api.github.com/users/srpearce/following{/other_user}","gists_url":"https://api.github.com/users/srpearce/gists{/gist_id}","starred_url":"https://api.github.com/users/srpearce/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srpearce/subscriptions","organizations_url":"https://api.github.com/users/srpearce/orgs","repos_url":"https://api.github.com/users/srpearce/repos","events_url":"https://api.github.com/users/srpearce/events{/privacy}","received_events_url":"https://api.github.com/users/srpearce/received_events","type":"User","site_admin":false},"body":"@pdesjardins @rlucioni Please review this section.","created_at":"2016-07-21T16:22:15Z","updated_at":"2016-07-21T16:22:15Z","html_url":"https://github.com/edx/edx-documentation/pull/1124#discussion_r71738114","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1124","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/71738114"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1124#discussion_r71738114"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1124"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/1124","id":77689458,"html_url":"https://github.com/edx/edx-documentation/pull/1124","diff_url":"https://github.com/edx/edx-documentation/pull/1124.diff","patch_url":"https://github.com/edx/edx-documentation/pull/1124.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/1124","number":1124,"state":"open","locked":false,"title":"Add a script to generate source files for new release notes","user":{"login":"pdesjardins","id":6510839,"avatar_url":"https://avatars.githubusercontent.com/u/6510839?v=3","gravatar_id":"","url":"https://api.github.com/users/pdesjardins","html_url":"https://github.com/pdesjardins","followers_url":"https://api.github.com/users/pdesjardins/followers","following_url":"https://api.github.com/users/pdesjardins/following{/other_user}","gists_url":"https://api.github.com/users/pdesjardins/gists{/gist_id}","starred_url":"https://api.github.com/users/pdesjardins/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pdesjardins/subscriptions","organizations_url":"https://api.github.com/users/pdesjardins/orgs","repos_url":"https://api.github.com/users/pdesjardins/repos","events_url":"https://api.github.com/users/pdesjardins/events{/privacy}","received_events_url":"https://api.github.com/users/pdesjardins/received_events","type":"User","site_admin":false},"body":"## [DOC-3142](https://openedx.atlassian.net/browse/DOC-3142)\r\n\r\nThis script adds an RST source file to the release notes source directory so that a contributor can easily add a release note. The script figures out the \"week of\" date for the next weekly release (naively, it doesn't try to predict skipped releases for holidays) and adds an empty file. The intention is that the documentation team member who is compiling release notes will include any files contributed this way in the index files later on.\r\n\r\nThis PR was prompted by a discussion @rlucioni convened, about developers contributing release notes. The script makes it easier to consistently conform to our file naming conventions.\r\n\r\nNote that the date format used by the script is YYYY-MM-DD, which I prefer because it orders nicely in directories. @lamagnifica suggested choosing a format other than the one we've been using for release note naming. It would be easy to alter the format, if anyone feels strongly.\r\n\r\nExample file name:\r\n\r\n  2016/documentation/documentation_2016-07-18.rst\r\n\r\nTo test:\r\n* Clone this branch.\r\n* In a command-line terminal, change to the edx-documentation/utilities directory.\r\n* Invoke ./add-upcoming-release-notes-file.sh.\r\n* Run \"git status\" to see what new RST files are in your source directory.\r\n* Open the new files in your RST editor.\r\n\r\n### Reviewers\r\n\r\nPossible roles follow. The PR submitter checks the boxes after each reviewer finishes and gives :+1:. \r\n\r\n- [x] Subject matter expert: @rlucioni \r\n- [ ] Subject matter expert: @lamagnifica \r\n- [x] Subject matter expert: @srpearce \r\n- [ ] Subject matter expert: @catong \r\n\r\n### Post-review\r\n\r\n- [ ] Squash commits\r\n\r\n","created_at":"2016-07-15T22:56:35Z","updated_at":"2016-07-21T16:22:15Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1785a8a75d2e0af3260faac37b8170b7d7f178e5","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1124/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1124/comments","review_comment_url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-documentation/issues/1124/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/aa56173a5c81b02fcdcf955fe6fb1638af6c409a","head":{"label":"edx:pdesjardins/DOC-3142","ref":"pdesjardins/DOC-3142","sha":"aa56173a5c81b02fcdcf955fe6fb1638af6c409a","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-07-04T03:40:08Z","pushed_at":"2016-07-21T16:21:24Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":106264,"stargazers_count":43,"watchers_count":43,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":139,"mirror_url":null,"open_issues_count":24,"forks":139,"open_issues":24,"watchers":43,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"65f5fa9492e826c2763b9e563dcc9bb94b230278","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-07-04T03:40:08Z","pushed_at":"2016-07-21T16:21:24Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":106264,"stargazers_count":43,"watchers_count":43,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":139,"mirror_url":null,"open_issues_count":24,"forks":139,"open_issues":24,"watchers":43,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1124"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1124"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1124"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1124/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1124/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1124/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/aa56173a5c81b02fcdcf955fe6fb1638af6c409a"}}}}
{"actor":{"display_login":"srpearce"}}