{"action":"created","comment":{"url":"https://api.github.com/repos/metomi/rose/pulls/comments/184081859","pull_request_review_id":115204290,"id":184081859,"diff_hunk":"@@ -14,10 +14,18 @@ site configuration at ``$ROSE_HOME/etc/rose.conf`` where\n search for the user configuration at ``$HOME/.metomi/rose.conf`` where\n ``$HOME`` is the home directory of the current user.\n \n-You can also override many internal constants of the ``rose config edit`` and\n+.. note::","path":"sphinx/api/configuration/site-and-user.rst","position":5,"original_position":5,"commit_id":"d4e9baa74b27199e50055a8d3a70605878268d0a","original_commit_id":"d4e9baa74b27199e50055a8d3a70605878268d0a","user":{"login":"sadielbartholomew","id":30274190,"avatar_url":"https://avatars2.githubusercontent.com/u/30274190?v=4","gravatar_id":"","url":"https://api.github.com/users/sadielbartholomew","html_url":"https://github.com/sadielbartholomew","followers_url":"https://api.github.com/users/sadielbartholomew/followers","following_url":"https://api.github.com/users/sadielbartholomew/following{/other_user}","gists_url":"https://api.github.com/users/sadielbartholomew/gists{/gist_id}","starred_url":"https://api.github.com/users/sadielbartholomew/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sadielbartholomew/subscriptions","organizations_url":"https://api.github.com/users/sadielbartholomew/orgs","repos_url":"https://api.github.com/users/sadielbartholomew/repos","events_url":"https://api.github.com/users/sadielbartholomew/events{/privacy}","received_events_url":"https://api.github.com/users/sadielbartholomew/received_events","type":"User","site_admin":false},"body":"This note is no longer applicable, the ``rose.conf`` settings section having being added in now.","created_at":"2018-04-25T14:32:42Z","updated_at":"2018-04-25T14:42:11Z","html_url":"https://github.com/metomi/rose/pull/2170#discussion_r184081859","pull_request_url":"https://api.github.com/repos/metomi/rose/pulls/2170","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/metomi/rose/pulls/comments/184081859"},"html":{"href":"https://github.com/metomi/rose/pull/2170#discussion_r184081859"},"pull_request":{"href":"https://api.github.com/repos/metomi/rose/pulls/2170"}}},"pull_request":{"url":"https://api.github.com/repos/metomi/rose/pulls/2170","id":178003182,"html_url":"https://github.com/metomi/rose/pull/2170","diff_url":"https://github.com/metomi/rose/pull/2170.diff","patch_url":"https://github.com/metomi/rose/pull/2170.patch","issue_url":"https://api.github.com/repos/metomi/rose/issues/2170","number":2170,"state":"open","locked":false,"title":"Rose user guide rose tutorial","user":{"login":"oliver-sanders","id":16705946,"avatar_url":"https://avatars0.githubusercontent.com/u/16705946?v=4","gravatar_id":"","url":"https://api.github.com/users/oliver-sanders","html_url":"https://github.com/oliver-sanders","followers_url":"https://api.github.com/users/oliver-sanders/followers","following_url":"https://api.github.com/users/oliver-sanders/following{/other_user}","gists_url":"https://api.github.com/users/oliver-sanders/gists{/gist_id}","starred_url":"https://api.github.com/users/oliver-sanders/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/oliver-sanders/subscriptions","organizations_url":"https://api.github.com/users/oliver-sanders/orgs","repos_url":"https://api.github.com/users/oliver-sanders/repos","events_url":"https://api.github.com/users/oliver-sanders/events{/privacy}","received_events_url":"https://api.github.com/users/oliver-sanders/received_events","type":"User","site_admin":false},"body":"~**Built on #2166, hold review until merged (will resolve conflicts after this merge).**~\r\n\r\nRose tutorial for the new documentation:\r\n\r\n* [x] What is rose\r\n* [x] Rose applications\r\n* [x] Rose metadata\r\n* [x] Rose suite configurations\r\n* [x] Rosie & FCM (needs finalisation)\r\n* [x] Additional rose topics (built-in apps, rose utilities)\r\n\r\nMain objectives for this content:\r\n\r\n* Explain rose configurations [in a generic sense] (purpose, format).\r\n* Convey the relationship between rose applications, suites and rose configurations.\r\n* Clarify the purpose of rose applications (namely encapsulation).\r\n* Clarify the purpose(s) of rose metadata.\r\n* Clarify the relationship between rose suite configurations and cylc suites (cylc suites with rose configurations).\r\n* Introduce and reinforce rose terminology.\r\n* Introduce the tools for evaluating rose configurations\r\n    * [x] `rose metadata-check`\r\n    * [ ] ~`rose config`~\r\n* Introduce the tools for running rose configurations\r\n    * [x] `rose app-run`\r\n    * [x] `rose suite-run`\r\n    * [x] `rose task-run`\r\n\r\nTo do in a future PR:\r\n\r\n* rose config?\r\n* rose config edit section?\r\n* rosie go section?\r\n* rose stem section\r\n\r\n~Ready for preliminary review (structure, approaches, etc).~","created_at":"2018-03-28T11:06:02Z","updated_at":"2018-04-25T14:42:11Z","closed_at":null,"merged_at":null,"merge_commit_sha":"63201c80c2c07b1e0b9c8c9872bb507c6a969f39","assignee":{"login":"oliver-sanders","id":16705946,"avatar_url":"https://avatars0.githubusercontent.com/u/16705946?v=4","gravatar_id":"","url":"https://api.github.com/users/oliver-sanders","html_url":"https://github.com/oliver-sanders","followers_url":"https://api.github.com/users/oliver-sanders/followers","following_url":"https://api.github.com/users/oliver-sanders/following{/other_user}","gists_url":"https://api.github.com/users/oliver-sanders/gists{/gist_id}","starred_url":"https://api.github.com/users/oliver-sanders/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/oliver-sanders/subscriptions","organizations_url":"https://api.github.com/users/oliver-sanders/orgs","repos_url":"https://api.github.com/users/oliver-sanders/repos","events_url":"https://api.github.com/users/oliver-sanders/events{/privacy}","received_events_url":"https://api.github.com/users/oliver-sanders/received_events","type":"User","site_admin":false},"assignees":[{"login":"oliver-sanders","id":16705946,"avatar_url":"https://avatars0.githubusercontent.com/u/16705946?v=4","gravatar_id":"","url":"https://api.github.com/users/oliver-sanders","html_url":"https://github.com/oliver-sanders","followers_url":"https://api.github.com/users/oliver-sanders/followers","following_url":"https://api.github.com/users/oliver-sanders/following{/other_user}","gists_url":"https://api.github.com/users/oliver-sanders/gists{/gist_id}","starred_url":"https://api.github.com/users/oliver-sanders/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/oliver-sanders/subscriptions","organizations_url":"https://api.github.com/users/oliver-sanders/orgs","repos_url":"https://api.github.com/users/oliver-sanders/repos","events_url":"https://api.github.com/users/oliver-sanders/events{/privacy}","received_events_url":"https://api.github.com/users/oliver-sanders/received_events","type":"User","site_admin":false}],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":{"url":"https://api.github.com/repos/metomi/rose/milestones/59","html_url":"https://github.com/metomi/rose/milestone/59","labels_url":"https://api.github.com/repos/metomi/rose/milestones/59/labels","id":3102205,"number":59,"title":"next-release","description":"Rose release 54.","creator":{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars3.githubusercontent.com/u/908613?v=4","gravatar_id":"","url":"https://api.github.com/users/matthewrmshin","html_url":"https://github.com/matthewrmshin","followers_url":"https://api.github.com/users/matthewrmshin/followers","following_url":"https://api.github.com/users/matthewrmshin/following{/other_user}","gists_url":"https://api.github.com/users/matthewrmshin/gists{/gist_id}","starred_url":"https://api.github.com/users/matthewrmshin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthewrmshin/subscriptions","organizations_url":"https://api.github.com/users/matthewrmshin/orgs","repos_url":"https://api.github.com/users/matthewrmshin/repos","events_url":"https://api.github.com/users/matthewrmshin/events{/privacy}","received_events_url":"https://api.github.com/users/matthewrmshin/received_events","type":"User","site_admin":false},"open_issues":4,"closed_issues":13,"state":"open","created_at":"2018-02-09T09:07:20Z","updated_at":"2018-04-25T10:52:50Z","due_on":"2018-04-30T07:00:00Z","closed_at":null},"commits_url":"https://api.github.com/repos/metomi/rose/pulls/2170/commits","review_comments_url":"https://api.github.com/repos/metomi/rose/pulls/2170/comments","review_comment_url":"https://api.github.com/repos/metomi/rose/pulls/comments{/number}","comments_url":"https://api.github.com/repos/metomi/rose/issues/2170/comments","statuses_url":"https://api.github.com/repos/metomi/rose/statuses/d4e9baa74b27199e50055a8d3a70605878268d0a","head":{"label":"oliver-sanders:rose-user-guide-rose-tutorial","ref":"rose-user-guide-rose-tutorial","sha":"d4e9baa74b27199e50055a8d3a70605878268d0a","user":{"login":"oliver-sanders","id":16705946,"avatar_url":"https://avatars0.githubusercontent.com/u/16705946?v=4","gravatar_id":"","url":"https://api.github.com/users/oliver-sanders","html_url":"https://github.com/oliver-sanders","followers_url":"https://api.github.com/users/oliver-sanders/followers","following_url":"https://api.github.com/users/oliver-sanders/following{/other_user}","gists_url":"https://api.github.com/users/oliver-sanders/gists{/gist_id}","starred_url":"https://api.github.com/users/oliver-sanders/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/oliver-sanders/subscriptions","organizations_url":"https://api.github.com/users/oliver-sanders/orgs","repos_url":"https://api.github.com/users/oliver-sanders/repos","events_url":"https://api.github.com/users/oliver-sanders/events{/privacy}","received_events_url":"https://api.github.com/users/oliver-sanders/received_events","type":"User","site_admin":false},"repo":{"id":49660258,"name":"rose","full_name":"oliver-sanders/rose","owner":{"login":"oliver-sanders","id":16705946,"avatar_url":"https://avatars0.githubusercontent.com/u/16705946?v=4","gravatar_id":"","url":"https://api.github.com/users/oliver-sanders","html_url":"https://github.com/oliver-sanders","followers_url":"https://api.github.com/users/oliver-sanders/followers","following_url":"https://api.github.com/users/oliver-sanders/following{/other_user}","gists_url":"https://api.github.com/users/oliver-sanders/gists{/gist_id}","starred_url":"https://api.github.com/users/oliver-sanders/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/oliver-sanders/subscriptions","organizations_url":"https://api.github.com/users/oliver-sanders/orgs","repos_url":"https://api.github.com/users/oliver-sanders/repos","events_url":"https://api.github.com/users/oliver-sanders/events{/privacy}","received_events_url":"https://api.github.com/users/oliver-sanders/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/oliver-sanders/rose","description":"Rose: a framework for managing and running meteorological suites.","fork":true,"url":"https://api.github.com/repos/oliver-sanders/rose","forks_url":"https://api.github.com/repos/oliver-sanders/rose/forks","keys_url":"https://api.github.com/repos/oliver-sanders/rose/keys{/key_id}","collaborators_url":"https://api.github.com/repos/oliver-sanders/rose/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/oliver-sanders/rose/teams","hooks_url":"https://api.github.com/repos/oliver-sanders/rose/hooks","issue_events_url":"https://api.github.com/repos/oliver-sanders/rose/issues/events{/number}","events_url":"https://api.github.com/repos/oliver-sanders/rose/events","assignees_url":"https://api.github.com/repos/oliver-sanders/rose/assignees{/user}","branches_url":"https://api.github.com/repos/oliver-sanders/rose/branches{/branch}","tags_url":"https://api.github.com/repos/oliver-sanders/rose/tags","blobs_url":"https://api.github.com/repos/oliver-sanders/rose/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/oliver-sanders/rose/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/oliver-sanders/rose/git/refs{/sha}","trees_url":"https://api.github.com/repos/oliver-sanders/rose/git/trees{/sha}","statuses_url":"https://api.github.com/repos/oliver-sanders/rose/statuses/{sha}","languages_url":"https://api.github.com/repos/oliver-sanders/rose/languages","stargazers_url":"https://api.github.com/repos/oliver-sanders/rose/stargazers","contributors_url":"https://api.github.com/repos/oliver-sanders/rose/contributors","subscribers_url":"https://api.github.com/repos/oliver-sanders/rose/subscribers","subscription_url":"https://api.github.com/repos/oliver-sanders/rose/subscription","commits_url":"https://api.github.com/repos/oliver-sanders/rose/commits{/sha}","git_commits_url":"https://api.github.com/repos/oliver-sanders/rose/git/commits{/sha}","comments_url":"https://api.github.com/repos/oliver-sanders/rose/comments{/number}","issue_comment_url":"https://api.github.com/repos/oliver-sanders/rose/issues/comments{/number}","contents_url":"https://api.github.com/repos/oliver-sanders/rose/contents/{+path}","compare_url":"https://api.github.com/repos/oliver-sanders/rose/compare/{base}...{head}","merges_url":"https://api.github.com/repos/oliver-sanders/rose/merges","archive_url":"https://api.github.com/repos/oliver-sanders/rose/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/oliver-sanders/rose/downloads","issues_url":"https://api.github.com/repos/oliver-sanders/rose/issues{/number}","pulls_url":"https://api.github.com/repos/oliver-sanders/rose/pulls{/number}","milestones_url":"https://api.github.com/repos/oliver-sanders/rose/milestones{/number}","notifications_url":"https://api.github.com/repos/oliver-sanders/rose/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/oliver-sanders/rose/labels{/name}","releases_url":"https://api.github.com/repos/oliver-sanders/rose/releases{/id}","deployments_url":"https://api.github.com/repos/oliver-sanders/rose/deployments","created_at":"2016-01-14T16:38:12Z","updated_at":"2017-11-14T16:12:55Z","pushed_at":"2018-04-25T14:12:34Z","git_url":"git://github.com/oliver-sanders/rose.git","ssh_url":"git@github.com:oliver-sanders/rose.git","clone_url":"https://github.com/oliver-sanders/rose.git","svn_url":"https://github.com/oliver-sanders/rose","homepage":"metomi.github.io/rose/doc/","size":18410,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"gpl-3.0","name":"GNU General Public License v3.0","spdx_id":"GPL-3.0","url":"https://api.github.com/licenses/gpl-3.0"},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"metomi:rose-user-guide-overhaul","ref":"rose-user-guide-overhaul","sha":"609eae8ff8d7a09388d6e623e1b84b4b5d96d21d","user":{"login":"metomi","id":2477494,"avatar_url":"https://avatars3.githubusercontent.com/u/2477494?v=4","gravatar_id":"","url":"https://api.github.com/users/metomi","html_url":"https://github.com/metomi","followers_url":"https://api.github.com/users/metomi/followers","following_url":"https://api.github.com/users/metomi/following{/other_user}","gists_url":"https://api.github.com/users/metomi/gists{/gist_id}","starred_url":"https://api.github.com/users/metomi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/metomi/subscriptions","organizations_url":"https://api.github.com/users/metomi/orgs","repos_url":"https://api.github.com/users/metomi/repos","events_url":"https://api.github.com/users/metomi/events{/privacy}","received_events_url":"https://api.github.com/users/metomi/received_events","type":"Organization","site_admin":false},"repo":{"id":6223866,"name":"rose","full_name":"metomi/rose","owner":{"login":"metomi","id":2477494,"avatar_url":"https://avatars3.githubusercontent.com/u/2477494?v=4","gravatar_id":"","url":"https://api.github.com/users/metomi","html_url":"https://github.com/metomi","followers_url":"https://api.github.com/users/metomi/followers","following_url":"https://api.github.com/users/metomi/following{/other_user}","gists_url":"https://api.github.com/users/metomi/gists{/gist_id}","starred_url":"https://api.github.com/users/metomi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/metomi/subscriptions","organizations_url":"https://api.github.com/users/metomi/orgs","repos_url":"https://api.github.com/users/metomi/repos","events_url":"https://api.github.com/users/metomi/events{/privacy}","received_events_url":"https://api.github.com/users/metomi/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/metomi/rose","description":":rose: Rose: a framework for managing and running meteorological suites.","fork":false,"url":"https://api.github.com/repos/metomi/rose","forks_url":"https://api.github.com/repos/metomi/rose/forks","keys_url":"https://api.github.com/repos/metomi/rose/keys{/key_id}","collaborators_url":"https://api.github.com/repos/metomi/rose/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/metomi/rose/teams","hooks_url":"https://api.github.com/repos/metomi/rose/hooks","issue_events_url":"https://api.github.com/repos/metomi/rose/issues/events{/number}","events_url":"https://api.github.com/repos/metomi/rose/events","assignees_url":"https://api.github.com/repos/metomi/rose/assignees{/user}","branches_url":"https://api.github.com/repos/metomi/rose/branches{/branch}","tags_url":"https://api.github.com/repos/metomi/rose/tags","blobs_url":"https://api.github.com/repos/metomi/rose/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/metomi/rose/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/metomi/rose/git/refs{/sha}","trees_url":"https://api.github.com/repos/metomi/rose/git/trees{/sha}","statuses_url":"https://api.github.com/repos/metomi/rose/statuses/{sha}","languages_url":"https://api.github.com/repos/metomi/rose/languages","stargazers_url":"https://api.github.com/repos/metomi/rose/stargazers","contributors_url":"https://api.github.com/repos/metomi/rose/contributors","subscribers_url":"https://api.github.com/repos/metomi/rose/subscribers","subscription_url":"https://api.github.com/repos/metomi/rose/subscription","commits_url":"https://api.github.com/repos/metomi/rose/commits{/sha}","git_commits_url":"https://api.github.com/repos/metomi/rose/git/commits{/sha}","comments_url":"https://api.github.com/repos/metomi/rose/comments{/number}","issue_comment_url":"https://api.github.com/repos/metomi/rose/issues/comments{/number}","contents_url":"https://api.github.com/repos/metomi/rose/contents/{+path}","compare_url":"https://api.github.com/repos/metomi/rose/compare/{base}...{head}","merges_url":"https://api.github.com/repos/metomi/rose/merges","archive_url":"https://api.github.com/repos/metomi/rose/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/metomi/rose/downloads","issues_url":"https://api.github.com/repos/metomi/rose/issues{/number}","pulls_url":"https://api.github.com/repos/metomi/rose/pulls{/number}","milestones_url":"https://api.github.com/repos/metomi/rose/milestones{/number}","notifications_url":"https://api.github.com/repos/metomi/rose/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/metomi/rose/labels{/name}","releases_url":"https://api.github.com/repos/metomi/rose/releases{/id}","deployments_url":"https://api.github.com/repos/metomi/rose/deployments","created_at":"2012-10-15T08:31:10Z","updated_at":"2018-04-16T15:40:13Z","pushed_at":"2018-04-25T14:12:36Z","git_url":"git://github.com/metomi/rose.git","ssh_url":"git@github.com:metomi/rose.git","clone_url":"https://github.com/metomi/rose.git","svn_url":"https://github.com/metomi/rose","homepage":"https://metomi.github.io/rose/doc/","size":17697,"stargazers_count":35,"watchers_count":35,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":32,"mirror_url":null,"archived":false,"open_issues_count":103,"license":{"key":"gpl-3.0","name":"GNU General Public License v3.0","spdx_id":"GPL-3.0","url":"https://api.github.com/licenses/gpl-3.0"},"forks":32,"open_issues":103,"watchers":35,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/metomi/rose/pulls/2170"},"html":{"href":"https://github.com/metomi/rose/pull/2170"},"issue":{"href":"https://api.github.com/repos/metomi/rose/issues/2170"},"comments":{"href":"https://api.github.com/repos/metomi/rose/issues/2170/comments"},"review_comments":{"href":"https://api.github.com/repos/metomi/rose/pulls/2170/comments"},"review_comment":{"href":"https://api.github.com/repos/metomi/rose/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/metomi/rose/pulls/2170/commits"},"statuses":{"href":"https://api.github.com/repos/metomi/rose/statuses/d4e9baa74b27199e50055a8d3a70605878268d0a"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"sadielbartholomew"}}