{"action":"created","comment":{"url":"https://api.github.com/repos/metomi/rose/pulls/comments/90453911","pull_request_review_id":10971739,"id":90453911,"diff_hunk":"@@ -586,40 +586,64 @@ <h3 id=\"dependencies-cycling\">Cycling\n               </div>\n \n               <div class=\"slide\">\n-                <h2 id=\"jinja2\">Jinja2</h2>\n+                <h2 id=\"parameterization\">Parameterization</h2>\n \n-                <p>cylc uses a templating language called Jinja2\n-                that you can use to collapse duplicated portions of\n-                configuration or insert settings.</p>\n+                <p>cylc provides an inbuilt templating language that you can\n+                use to generate repeated graphing and runtime entries by\n+                working through a list of parameter values.</p>\n \n-                <p>This means that you can embed special\n-                instruction code in the <samp>suite.rc</samp> file\n-                to generate or insert text that will be expanded at\n-                runtime.</p>\n+                <p>This allows you to reduce down sections of the\n+                <samp>suite.rc</samp> file into special instruction code that\n+                will be expanded by cylc at runtime.</p>\n               </div>\n \n               <div class=\"slide\">\n-                <h3 class=\"alwayshidden\">Jinja2 Loop</h3>\n+                <h2 id=\"parameterized-graphing\">Parameterized graphing</h2>\n \n-                <p>This can be especially useful when you have a\n-                lot of repetition - for example, in an ensemble\n-                context. You can use <code>if</code> and\n-                <code>for</code> blocks, amongst other things:</p>\n+                <p>This can be particularly useful when you have large amounts\n+                of repetition - for example, in an ensemble context.</p>\n+\n+                <p>Sets of parameters are configured in the\n+                <samp>[cylc][[parameters]]</samp> section. For example:</p>\n+                <pre class=\"prettyprint lang-cylc\">\n+[cylc]\r\n+   [[parameters]]\r\n+         world = eris, pluto, makemake, haumea\n+</pre>\n+                <p>You can then get cylc to work through a set of parameters\n+                using <var>&lt;parameter&gt;</var> tags.\n                 <pre class=\"prettyprint lang-cylc\">\n-{%- for WORLD in [\"eris\", \"pluto\", \"makemake\", \"haumea\"] %}\n-  [[hello_{{ WORLD }}]]\n+[scheduling]\r\n+   [[dependencies]]\r\n+         graph = hello_&lt;world&gt;\r\n+</pre>\n+              </div>\n+\n+              <div class=\"slide\">\n+                <h2 id=\"parameterized-runtime\">Parameterized runtime</h2>","path":"doc/rose-rug-suites-I.html","position":53,"original_position":53,"commit_id":"9a9d22b39ecd89a01ec141e53fd2dc26201396e4","original_commit_id":"9a9d22b39ecd89a01ec141e53fd2dc26201396e4","user":{"login":"oliver-sanders","id":16705946,"avatar_url":"https://avatars.githubusercontent.com/u/16705946?v=3","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":"`<h3>` ?","created_at":"2016-12-01T14:15:57Z","updated_at":"2016-12-01T14:30:06Z","html_url":"https://github.com/metomi/rose/pull/2023#discussion_r90453911","pull_request_url":"https://api.github.com/repos/metomi/rose/pulls/2023","_links":{"self":{"href":"https://api.github.com/repos/metomi/rose/pulls/comments/90453911"},"html":{"href":"https://github.com/metomi/rose/pull/2023#discussion_r90453911"},"pull_request":{"href":"https://api.github.com/repos/metomi/rose/pulls/2023"}}},"pull_request":{"url":"https://api.github.com/repos/metomi/rose/pulls/2023","id":95904748,"html_url":"https://github.com/metomi/rose/pull/2023","diff_url":"https://github.com/metomi/rose/pull/2023.diff","patch_url":"https://github.com/metomi/rose/pull/2023.patch","issue_url":"https://api.github.com/repos/metomi/rose/issues/2023","number":2023,"state":"open","locked":false,"title":"docs: Update suites-I to parameterization.","user":{"login":"arjclark","id":2562650,"avatar_url":"https://avatars.githubusercontent.com/u/2562650?v=3","gravatar_id":"","url":"https://api.github.com/users/arjclark","html_url":"https://github.com/arjclark","followers_url":"https://api.github.com/users/arjclark/followers","following_url":"https://api.github.com/users/arjclark/following{/other_user}","gists_url":"https://api.github.com/users/arjclark/gists{/gist_id}","starred_url":"https://api.github.com/users/arjclark/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arjclark/subscriptions","organizations_url":"https://api.github.com/users/arjclark/orgs","repos_url":"https://api.github.com/users/arjclark/repos","events_url":"https://api.github.com/users/arjclark/events{/privacy}","received_events_url":"https://api.github.com/users/arjclark/received_events","type":"User","site_admin":false},"body":"This replaces the Jinja2 looping part of suites-I with parametrization - the now preferred way of doing that.\r\n\r\nJinja2 is kept in but with a more relevant `if` block example.\r\n\r\nA more more in-depth parameterization tutorial can be done in a follow up pull request if we feel this example and those given in the cylc user guide are insufficient (the cylc ones are pretty good tbh for any advanced usage of pure parameterization - I'm tempted to do a blended Jinja2 and parameters one though).\r\n\r\n@matthewrmshin - please review 1 and make sure you're happy with the new baseline advice\r\n@oliver-sanders - please review 2 (but wait till Matt's happy with the general gist first)","created_at":"2016-11-30T14:47:53Z","updated_at":"2016-12-01T14:30:06Z","closed_at":null,"merged_at":null,"merge_commit_sha":"50207b959c056ac5ab995722b61ba687dfe4012a","assignee":{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars.githubusercontent.com/u/908613?v=3","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},"assignees":[{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars.githubusercontent.com/u/908613?v=3","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},{"login":"oliver-sanders","id":16705946,"avatar_url":"https://avatars.githubusercontent.com/u/16705946?v=3","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}],"milestone":{"url":"https://api.github.com/repos/metomi/rose/milestones/52","html_url":"https://github.com/metomi/rose/milestones/next-release","labels_url":"https://api.github.com/repos/metomi/rose/milestones/52/labels","id":2163758,"number":52,"title":"next-release","description":"Rose release 47","creator":{"login":"matthewrmshin","id":908613,"avatar_url":"https://avatars.githubusercontent.com/u/908613?v=3","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":2,"closed_issues":0,"state":"open","created_at":"2016-11-29T14:27:14Z","updated_at":"2016-11-30T14:47:53Z","due_on":"2016-12-30T00:00:00Z","closed_at":null},"commits_url":"https://api.github.com/repos/metomi/rose/pulls/2023/commits","review_comments_url":"https://api.github.com/repos/metomi/rose/pulls/2023/comments","review_comment_url":"https://api.github.com/repos/metomi/rose/pulls/comments{/number}","comments_url":"https://api.github.com/repos/metomi/rose/issues/2023/comments","statuses_url":"https://api.github.com/repos/metomi/rose/statuses/9a9d22b39ecd89a01ec141e53fd2dc26201396e4","head":{"label":"arjclark:docs.jinja2_to_params","ref":"docs.jinja2_to_params","sha":"9a9d22b39ecd89a01ec141e53fd2dc26201396e4","user":{"login":"arjclark","id":2562650,"avatar_url":"https://avatars.githubusercontent.com/u/2562650?v=3","gravatar_id":"","url":"https://api.github.com/users/arjclark","html_url":"https://github.com/arjclark","followers_url":"https://api.github.com/users/arjclark/followers","following_url":"https://api.github.com/users/arjclark/following{/other_user}","gists_url":"https://api.github.com/users/arjclark/gists{/gist_id}","starred_url":"https://api.github.com/users/arjclark/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arjclark/subscriptions","organizations_url":"https://api.github.com/users/arjclark/orgs","repos_url":"https://api.github.com/users/arjclark/repos","events_url":"https://api.github.com/users/arjclark/events{/privacy}","received_events_url":"https://api.github.com/users/arjclark/received_events","type":"User","site_admin":false},"repo":{"id":6224478,"name":"rose","full_name":"arjclark/rose","owner":{"login":"arjclark","id":2562650,"avatar_url":"https://avatars.githubusercontent.com/u/2562650?v=3","gravatar_id":"","url":"https://api.github.com/users/arjclark","html_url":"https://github.com/arjclark","followers_url":"https://api.github.com/users/arjclark/followers","following_url":"https://api.github.com/users/arjclark/following{/other_user}","gists_url":"https://api.github.com/users/arjclark/gists{/gist_id}","starred_url":"https://api.github.com/users/arjclark/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arjclark/subscriptions","organizations_url":"https://api.github.com/users/arjclark/orgs","repos_url":"https://api.github.com/users/arjclark/repos","events_url":"https://api.github.com/users/arjclark/events{/privacy}","received_events_url":"https://api.github.com/users/arjclark/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/arjclark/rose","description":"Rose is a framework for managing and running meteorological suites.","fork":true,"url":"https://api.github.com/repos/arjclark/rose","forks_url":"https://api.github.com/repos/arjclark/rose/forks","keys_url":"https://api.github.com/repos/arjclark/rose/keys{/key_id}","collaborators_url":"https://api.github.com/repos/arjclark/rose/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/arjclark/rose/teams","hooks_url":"https://api.github.com/repos/arjclark/rose/hooks","issue_events_url":"https://api.github.com/repos/arjclark/rose/issues/events{/number}","events_url":"https://api.github.com/repos/arjclark/rose/events","assignees_url":"https://api.github.com/repos/arjclark/rose/assignees{/user}","branches_url":"https://api.github.com/repos/arjclark/rose/branches{/branch}","tags_url":"https://api.github.com/repos/arjclark/rose/tags","blobs_url":"https://api.github.com/repos/arjclark/rose/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/arjclark/rose/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/arjclark/rose/git/refs{/sha}","trees_url":"https://api.github.com/repos/arjclark/rose/git/trees{/sha}","statuses_url":"https://api.github.com/repos/arjclark/rose/statuses/{sha}","languages_url":"https://api.github.com/repos/arjclark/rose/languages","stargazers_url":"https://api.github.com/repos/arjclark/rose/stargazers","contributors_url":"https://api.github.com/repos/arjclark/rose/contributors","subscribers_url":"https://api.github.com/repos/arjclark/rose/subscribers","subscription_url":"https://api.github.com/repos/arjclark/rose/subscription","commits_url":"https://api.github.com/repos/arjclark/rose/commits{/sha}","git_commits_url":"https://api.github.com/repos/arjclark/rose/git/commits{/sha}","comments_url":"https://api.github.com/repos/arjclark/rose/comments{/number}","issue_comment_url":"https://api.github.com/repos/arjclark/rose/issues/comments{/number}","contents_url":"https://api.github.com/repos/arjclark/rose/contents/{+path}","compare_url":"https://api.github.com/repos/arjclark/rose/compare/{base}...{head}","merges_url":"https://api.github.com/repos/arjclark/rose/merges","archive_url":"https://api.github.com/repos/arjclark/rose/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/arjclark/rose/downloads","issues_url":"https://api.github.com/repos/arjclark/rose/issues{/number}","pulls_url":"https://api.github.com/repos/arjclark/rose/pulls{/number}","milestones_url":"https://api.github.com/repos/arjclark/rose/milestones{/number}","notifications_url":"https://api.github.com/repos/arjclark/rose/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/arjclark/rose/labels{/name}","releases_url":"https://api.github.com/repos/arjclark/rose/releases{/id}","deployments_url":"https://api.github.com/repos/arjclark/rose/deployments","created_at":"2012-10-15T09:21:14Z","updated_at":"2015-05-07T13:18:05Z","pushed_at":"2016-11-30T14:43:26Z","git_url":"git://github.com/arjclark/rose.git","ssh_url":"git@github.com:arjclark/rose.git","clone_url":"https://github.com/arjclark/rose.git","svn_url":"https://github.com/arjclark/rose","homepage":null,"size":15599,"stargazers_count":1,"watchers_count":1,"language":"Python","has_issues":false,"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":1,"default_branch":"master"}},"base":{"label":"metomi:master","ref":"master","sha":"992d142cfff9ca002a15d6c7fbb6a265b20cd15d","user":{"login":"metomi","id":2477494,"avatar_url":"https://avatars.githubusercontent.com/u/2477494?v=3","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://avatars.githubusercontent.com/u/2477494?v=3","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: 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":"2016-11-24T11:16:14Z","pushed_at":"2016-11-30T14:47:53Z","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":"metomi.github.io/rose/doc/","size":18808,"stargazers_count":22,"watchers_count":22,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":28,"mirror_url":null,"open_issues_count":90,"forks":28,"open_issues":90,"watchers":22,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/metomi/rose/pulls/2023"},"html":{"href":"https://github.com/metomi/rose/pull/2023"},"issue":{"href":"https://api.github.com/repos/metomi/rose/issues/2023"},"comments":{"href":"https://api.github.com/repos/metomi/rose/issues/2023/comments"},"review_comments":{"href":"https://api.github.com/repos/metomi/rose/pulls/2023/comments"},"review_comment":{"href":"https://api.github.com/repos/metomi/rose/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/metomi/rose/pulls/2023/commits"},"statuses":{"href":"https://api.github.com/repos/metomi/rose/statuses/9a9d22b39ecd89a01ec141e53fd2dc26201396e4"}}}}
{"actor":{"display_login":"oliver-sanders"}}