{"action":"created","comment":{"url":"https://api.github.com/repos/cylc/cylc/pulls/comments/134342440","pull_request_review_id":57622339,"id":134342440,"diff_hunk":"@@ -13,39 +13,50 @@ \\subsection{Top Level Items}\n The only top level configuration items at present are the suite title\n and description.\n \n-\\subsubsection{title}\n+\\subsubsection{group}\n \n-A single line description of the suite. It is displayed in the db viewer\n-window and can be retrieved at run time with the\n+A single line group name for a suite. It is displayed in the gscan\n+window and can be used as a way of grouping related suites together.\n \\lstinline=cylc show= command.\n \n \\begin{myitemize}\n \\item {\\em type:} single line string\n \\item {\\em default:} (none)\n \\end{myitemize}\n \n-\\subsubsection{description}\n \n-A multi-line description of the suite. It can be retrieved by the db viewer\n-right-click menu, or at run time with the \\lstinline=cylc show= command.\n+\\subsection{[meta]}\n+\n+Section containing metadata items for this suite. Several items\n+(title, description, URL) are pre-defined and are used by the GUI. Others can be \n+user-defined and passed to suite event handlers to be interpreted according to your \n+needs. For example, the value of an \"suite-priority\" item could determine how an event \n+handler responds to failure events.\n+\n+\n+\\subsubsection[title]{ [meta] \\textrightarrow title}\n+\n+A single line description of the suite. It is displayed in the db viewer","path":"doc/src/cylc-user-guide/suiterc.tex","position":33,"original_position":33,"commit_id":"9d8d38ac6319639c5d8f66d6d72e3169ff5ed1e9","original_commit_id":"9d8d38ac6319639c5d8f66d6d72e3169ff5ed1e9","user":{"login":"hjoliver","id":2362137,"avatar_url":"https://avatars0.githubusercontent.com/u/2362137?v=4","gravatar_id":"","url":"https://api.github.com/users/hjoliver","html_url":"https://github.com/hjoliver","followers_url":"https://api.github.com/users/hjoliver/followers","following_url":"https://api.github.com/users/hjoliver/following{/other_user}","gists_url":"https://api.github.com/users/hjoliver/gists{/gist_id}","starred_url":"https://api.github.com/users/hjoliver/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hjoliver/subscriptions","organizations_url":"https://api.github.com/users/hjoliver/orgs","repos_url":"https://api.github.com/users/hjoliver/repos","events_url":"https://api.github.com/users/hjoliver/events{/privacy}","received_events_url":"https://api.github.com/users/hjoliver/received_events","type":"User","site_admin":false},"body":"Not your fault, but \"db viewer\" is long outdated.  Can you change that to 'displayed in the GUI \"Open Another Suite\" window'.","created_at":"2017-08-21T22:03:04Z","updated_at":"2017-08-21T22:07:11Z","html_url":"https://github.com/cylc/cylc/pull/2387#discussion_r134342440","pull_request_url":"https://api.github.com/repos/cylc/cylc/pulls/2387","_links":{"self":{"href":"https://api.github.com/repos/cylc/cylc/pulls/comments/134342440"},"html":{"href":"https://github.com/cylc/cylc/pull/2387#discussion_r134342440"},"pull_request":{"href":"https://api.github.com/repos/cylc/cylc/pulls/2387"}}},"pull_request":{"url":"https://api.github.com/repos/cylc/cylc/pulls/2387","id":135017781,"html_url":"https://github.com/cylc/cylc/pull/2387","diff_url":"https://github.com/cylc/cylc/pull/2387.diff","patch_url":"https://github.com/cylc/cylc/pull/2387.patch","issue_url":"https://api.github.com/repos/cylc/cylc/issues/2387","number":2387,"state":"open","locked":false,"title":"Put suite metadata items in a meta section","user":{"login":"challurip","id":23368119,"avatar_url":"https://avatars2.githubusercontent.com/u/23368119?v=4","gravatar_id":"","url":"https://api.github.com/users/challurip","html_url":"https://github.com/challurip","followers_url":"https://api.github.com/users/challurip/followers","following_url":"https://api.github.com/users/challurip/following{/other_user}","gists_url":"https://api.github.com/users/challurip/gists{/gist_id}","starred_url":"https://api.github.com/users/challurip/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/challurip/subscriptions","organizations_url":"https://api.github.com/users/challurip/orgs","repos_url":"https://api.github.com/users/challurip/repos","events_url":"https://api.github.com/users/challurip/events{/privacy}","received_events_url":"https://api.github.com/users/challurip/received_events","type":"User","site_admin":false},"body":"meta section of suite contains title, description, URL and other user-defined items about suite.","created_at":"2017-08-10T00:19:44Z","updated_at":"2017-08-21T22:07:12Z","closed_at":null,"merged_at":null,"merge_commit_sha":"ff9f05fd1da2ac332f87b6205c159b7da77b529f","assignee":{"login":"challurip","id":23368119,"avatar_url":"https://avatars2.githubusercontent.com/u/23368119?v=4","gravatar_id":"","url":"https://api.github.com/users/challurip","html_url":"https://github.com/challurip","followers_url":"https://api.github.com/users/challurip/followers","following_url":"https://api.github.com/users/challurip/following{/other_user}","gists_url":"https://api.github.com/users/challurip/gists{/gist_id}","starred_url":"https://api.github.com/users/challurip/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/challurip/subscriptions","organizations_url":"https://api.github.com/users/challurip/orgs","repos_url":"https://api.github.com/users/challurip/repos","events_url":"https://api.github.com/users/challurip/events{/privacy}","received_events_url":"https://api.github.com/users/challurip/received_events","type":"User","site_admin":false},"assignees":[{"login":"challurip","id":23368119,"avatar_url":"https://avatars2.githubusercontent.com/u/23368119?v=4","gravatar_id":"","url":"https://api.github.com/users/challurip","html_url":"https://github.com/challurip","followers_url":"https://api.github.com/users/challurip/followers","following_url":"https://api.github.com/users/challurip/following{/other_user}","gists_url":"https://api.github.com/users/challurip/gists{/gist_id}","starred_url":"https://api.github.com/users/challurip/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/challurip/subscriptions","organizations_url":"https://api.github.com/users/challurip/orgs","repos_url":"https://api.github.com/users/challurip/repos","events_url":"https://api.github.com/users/challurip/events{/privacy}","received_events_url":"https://api.github.com/users/challurip/received_events","type":"User","site_admin":false}],"requested_reviewers":[],"milestone":{"url":"https://api.github.com/repos/cylc/cylc/milestones/66","html_url":"https://github.com/cylc/cylc/milestone/66","labels_url":"https://api.github.com/repos/cylc/cylc/milestones/66/labels","id":2522339,"number":66,"title":"next release","description":"7.5.0","creator":{"login":"hjoliver","id":2362137,"avatar_url":"https://avatars0.githubusercontent.com/u/2362137?v=4","gravatar_id":"","url":"https://api.github.com/users/hjoliver","html_url":"https://github.com/hjoliver","followers_url":"https://api.github.com/users/hjoliver/followers","following_url":"https://api.github.com/users/hjoliver/following{/other_user}","gists_url":"https://api.github.com/users/hjoliver/gists{/gist_id}","starred_url":"https://api.github.com/users/hjoliver/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hjoliver/subscriptions","organizations_url":"https://api.github.com/users/hjoliver/orgs","repos_url":"https://api.github.com/users/hjoliver/repos","events_url":"https://api.github.com/users/hjoliver/events{/privacy}","received_events_url":"https://api.github.com/users/hjoliver/received_events","type":"User","site_admin":false},"open_issues":1,"closed_issues":97,"state":"open","created_at":"2017-05-15T20:08:11Z","updated_at":"2017-08-21T21:40:55Z","due_on":"2017-08-25T07:00:00Z","closed_at":null},"commits_url":"https://api.github.com/repos/cylc/cylc/pulls/2387/commits","review_comments_url":"https://api.github.com/repos/cylc/cylc/pulls/2387/comments","review_comment_url":"https://api.github.com/repos/cylc/cylc/pulls/comments{/number}","comments_url":"https://api.github.com/repos/cylc/cylc/issues/2387/comments","statuses_url":"https://api.github.com/repos/cylc/cylc/statuses/9d8d38ac6319639c5d8f66d6d72e3169ff5ed1e9","head":{"label":"challurip:suite-meta","ref":"suite-meta","sha":"9d8d38ac6319639c5d8f66d6d72e3169ff5ed1e9","user":{"login":"challurip","id":23368119,"avatar_url":"https://avatars2.githubusercontent.com/u/23368119?v=4","gravatar_id":"","url":"https://api.github.com/users/challurip","html_url":"https://github.com/challurip","followers_url":"https://api.github.com/users/challurip/followers","following_url":"https://api.github.com/users/challurip/following{/other_user}","gists_url":"https://api.github.com/users/challurip/gists{/gist_id}","starred_url":"https://api.github.com/users/challurip/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/challurip/subscriptions","organizations_url":"https://api.github.com/users/challurip/orgs","repos_url":"https://api.github.com/users/challurip/repos","events_url":"https://api.github.com/users/challurip/events{/privacy}","received_events_url":"https://api.github.com/users/challurip/received_events","type":"User","site_admin":false},"repo":{"id":85755601,"name":"cylc","full_name":"challurip/cylc","owner":{"login":"challurip","id":23368119,"avatar_url":"https://avatars2.githubusercontent.com/u/23368119?v=4","gravatar_id":"","url":"https://api.github.com/users/challurip","html_url":"https://github.com/challurip","followers_url":"https://api.github.com/users/challurip/followers","following_url":"https://api.github.com/users/challurip/following{/other_user}","gists_url":"https://api.github.com/users/challurip/gists{/gist_id}","starred_url":"https://api.github.com/users/challurip/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/challurip/subscriptions","organizations_url":"https://api.github.com/users/challurip/orgs","repos_url":"https://api.github.com/users/challurip/repos","events_url":"https://api.github.com/users/challurip/events{/privacy}","received_events_url":"https://api.github.com/users/challurip/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/challurip/cylc","description":"Cylc, a workflow engine for cycling tasks.","fork":true,"url":"https://api.github.com/repos/challurip/cylc","forks_url":"https://api.github.com/repos/challurip/cylc/forks","keys_url":"https://api.github.com/repos/challurip/cylc/keys{/key_id}","collaborators_url":"https://api.github.com/repos/challurip/cylc/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/challurip/cylc/teams","hooks_url":"https://api.github.com/repos/challurip/cylc/hooks","issue_events_url":"https://api.github.com/repos/challurip/cylc/issues/events{/number}","events_url":"https://api.github.com/repos/challurip/cylc/events","assignees_url":"https://api.github.com/repos/challurip/cylc/assignees{/user}","branches_url":"https://api.github.com/repos/challurip/cylc/branches{/branch}","tags_url":"https://api.github.com/repos/challurip/cylc/tags","blobs_url":"https://api.github.com/repos/challurip/cylc/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/challurip/cylc/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/challurip/cylc/git/refs{/sha}","trees_url":"https://api.github.com/repos/challurip/cylc/git/trees{/sha}","statuses_url":"https://api.github.com/repos/challurip/cylc/statuses/{sha}","languages_url":"https://api.github.com/repos/challurip/cylc/languages","stargazers_url":"https://api.github.com/repos/challurip/cylc/stargazers","contributors_url":"https://api.github.com/repos/challurip/cylc/contributors","subscribers_url":"https://api.github.com/repos/challurip/cylc/subscribers","subscription_url":"https://api.github.com/repos/challurip/cylc/subscription","commits_url":"https://api.github.com/repos/challurip/cylc/commits{/sha}","git_commits_url":"https://api.github.com/repos/challurip/cylc/git/commits{/sha}","comments_url":"https://api.github.com/repos/challurip/cylc/comments{/number}","issue_comment_url":"https://api.github.com/repos/challurip/cylc/issues/comments{/number}","contents_url":"https://api.github.com/repos/challurip/cylc/contents/{+path}","compare_url":"https://api.github.com/repos/challurip/cylc/compare/{base}...{head}","merges_url":"https://api.github.com/repos/challurip/cylc/merges","archive_url":"https://api.github.com/repos/challurip/cylc/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/challurip/cylc/downloads","issues_url":"https://api.github.com/repos/challurip/cylc/issues{/number}","pulls_url":"https://api.github.com/repos/challurip/cylc/pulls{/number}","milestones_url":"https://api.github.com/repos/challurip/cylc/milestones{/number}","notifications_url":"https://api.github.com/repos/challurip/cylc/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/challurip/cylc/labels{/name}","releases_url":"https://api.github.com/repos/challurip/cylc/releases{/id}","deployments_url":"https://api.github.com/repos/challurip/cylc/deployments","created_at":"2017-03-21T21:31:18Z","updated_at":"2017-03-21T21:31:24Z","pushed_at":"2017-08-21T00:25:25Z","git_url":"git://github.com/challurip/cylc.git","ssh_url":"git@github.com:challurip/cylc.git","clone_url":"https://github.com/challurip/cylc.git","svn_url":"https://github.com/challurip/cylc","homepage":"https://cylc.github.io/cylc","size":113975,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"cylc:master","ref":"master","sha":"976f75b92d4524e4e0ab63f87a46427b5eedb3fb","user":{"login":"cylc","id":824878,"avatar_url":"https://avatars1.githubusercontent.com/u/824878?v=4","gravatar_id":"","url":"https://api.github.com/users/cylc","html_url":"https://github.com/cylc","followers_url":"https://api.github.com/users/cylc/followers","following_url":"https://api.github.com/users/cylc/following{/other_user}","gists_url":"https://api.github.com/users/cylc/gists{/gist_id}","starred_url":"https://api.github.com/users/cylc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cylc/subscriptions","organizations_url":"https://api.github.com/users/cylc/orgs","repos_url":"https://api.github.com/users/cylc/repos","events_url":"https://api.github.com/users/cylc/events{/privacy}","received_events_url":"https://api.github.com/users/cylc/received_events","type":"Organization","site_admin":false},"repo":{"id":1836229,"name":"cylc","full_name":"cylc/cylc","owner":{"login":"cylc","id":824878,"avatar_url":"https://avatars1.githubusercontent.com/u/824878?v=4","gravatar_id":"","url":"https://api.github.com/users/cylc","html_url":"https://github.com/cylc","followers_url":"https://api.github.com/users/cylc/followers","following_url":"https://api.github.com/users/cylc/following{/other_user}","gists_url":"https://api.github.com/users/cylc/gists{/gist_id}","starred_url":"https://api.github.com/users/cylc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cylc/subscriptions","organizations_url":"https://api.github.com/users/cylc/orgs","repos_url":"https://api.github.com/users/cylc/repos","events_url":"https://api.github.com/users/cylc/events{/privacy}","received_events_url":"https://api.github.com/users/cylc/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/cylc/cylc","description":"Cylc, a workflow engine for cycling tasks.","fork":false,"url":"https://api.github.com/repos/cylc/cylc","forks_url":"https://api.github.com/repos/cylc/cylc/forks","keys_url":"https://api.github.com/repos/cylc/cylc/keys{/key_id}","collaborators_url":"https://api.github.com/repos/cylc/cylc/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/cylc/cylc/teams","hooks_url":"https://api.github.com/repos/cylc/cylc/hooks","issue_events_url":"https://api.github.com/repos/cylc/cylc/issues/events{/number}","events_url":"https://api.github.com/repos/cylc/cylc/events","assignees_url":"https://api.github.com/repos/cylc/cylc/assignees{/user}","branches_url":"https://api.github.com/repos/cylc/cylc/branches{/branch}","tags_url":"https://api.github.com/repos/cylc/cylc/tags","blobs_url":"https://api.github.com/repos/cylc/cylc/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/cylc/cylc/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/cylc/cylc/git/refs{/sha}","trees_url":"https://api.github.com/repos/cylc/cylc/git/trees{/sha}","statuses_url":"https://api.github.com/repos/cylc/cylc/statuses/{sha}","languages_url":"https://api.github.com/repos/cylc/cylc/languages","stargazers_url":"https://api.github.com/repos/cylc/cylc/stargazers","contributors_url":"https://api.github.com/repos/cylc/cylc/contributors","subscribers_url":"https://api.github.com/repos/cylc/cylc/subscribers","subscription_url":"https://api.github.com/repos/cylc/cylc/subscription","commits_url":"https://api.github.com/repos/cylc/cylc/commits{/sha}","git_commits_url":"https://api.github.com/repos/cylc/cylc/git/commits{/sha}","comments_url":"https://api.github.com/repos/cylc/cylc/comments{/number}","issue_comment_url":"https://api.github.com/repos/cylc/cylc/issues/comments{/number}","contents_url":"https://api.github.com/repos/cylc/cylc/contents/{+path}","compare_url":"https://api.github.com/repos/cylc/cylc/compare/{base}...{head}","merges_url":"https://api.github.com/repos/cylc/cylc/merges","archive_url":"https://api.github.com/repos/cylc/cylc/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/cylc/cylc/downloads","issues_url":"https://api.github.com/repos/cylc/cylc/issues{/number}","pulls_url":"https://api.github.com/repos/cylc/cylc/pulls{/number}","milestones_url":"https://api.github.com/repos/cylc/cylc/milestones{/number}","notifications_url":"https://api.github.com/repos/cylc/cylc/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/cylc/cylc/labels{/name}","releases_url":"https://api.github.com/repos/cylc/cylc/releases{/id}","deployments_url":"https://api.github.com/repos/cylc/cylc/deployments","created_at":"2011-06-02T08:31:49Z","updated_at":"2017-06-17T06:05:42Z","pushed_at":"2017-08-21T21:40:55Z","git_url":"git://github.com/cylc/cylc.git","ssh_url":"git@github.com:cylc/cylc.git","clone_url":"https://github.com/cylc/cylc.git","svn_url":"https://github.com/cylc/cylc","homepage":"https://cylc.github.io/cylc","size":118144,"stargazers_count":52,"watchers_count":52,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":35,"mirror_url":null,"open_issues_count":121,"forks":35,"open_issues":121,"watchers":52,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/cylc/cylc/pulls/2387"},"html":{"href":"https://github.com/cylc/cylc/pull/2387"},"issue":{"href":"https://api.github.com/repos/cylc/cylc/issues/2387"},"comments":{"href":"https://api.github.com/repos/cylc/cylc/issues/2387/comments"},"review_comments":{"href":"https://api.github.com/repos/cylc/cylc/pulls/2387/comments"},"review_comment":{"href":"https://api.github.com/repos/cylc/cylc/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/cylc/cylc/pulls/2387/commits"},"statuses":{"href":"https://api.github.com/repos/cylc/cylc/statuses/9d8d38ac6319639c5d8f66d6d72e3169ff5ed1e9"}}}}
{"actor":{"display_login":"hjoliver"}}