{"action":"created","comment":{"url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/comments/55056622","id":55056622,"diff_hunk":"@@ -169,25 +181,25 @@ POST /api/v1/map/named/:template_name\n \n Param | Description\n --- | ---\n-auth_token | optional, but required when `\"method\"` is set to `\"token\"`\n+auth_token | `\"token\"` or `\"open\"` (`\"open\"` is the default if not specified. Use `\"token\"` to password-protect your map)\n \n ```javascript\n-// params.json\n+// params.json, this is required if the Named Map allows variables (if placeholders were defined in the MapConfig/template.json by the user)\n {\n  \"color\": \"#ff0000\",\n  \"cartodb_id\": 3\n }\n ```\n \n-The fields you pass as `params.json` depend on the variables allowed by the named map. If there are variables missing it will raise an error (HTTP 400)\n+The fields you pass as `params.json` depend on the variables allowed by the Named Map. If there are variables missing, it will raise an error (HTTP 400).\n \n-- **auth_token** *optional* if the named map needs auth\n+**Note:** It is required that you include a `params.json` file to instantiate a Named Map that contains variables, even if you have no fields to pass and the JSON is empty. (This is specific to when a Named Map allows variables (if placeholders were defined in the MapConfig/template.json by the user).","path":"docs/named_maps.md","position":144,"original_position":144,"commit_id":"14f58e12bbf47c79fc216804a4d9e19622cb8514","original_commit_id":"14f58e12bbf47c79fc216804a4d9e19622cb8514","user":{"login":"iriberri","id":1730320,"avatar_url":"https://avatars.githubusercontent.com/u/1730320?v=3","gravatar_id":"","url":"https://api.github.com/users/iriberri","html_url":"https://github.com/iriberri","followers_url":"https://api.github.com/users/iriberri/followers","following_url":"https://api.github.com/users/iriberri/following{/other_user}","gists_url":"https://api.github.com/users/iriberri/gists{/gist_id}","starred_url":"https://api.github.com/users/iriberri/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/iriberri/subscriptions","organizations_url":"https://api.github.com/users/iriberri/orgs","repos_url":"https://api.github.com/users/iriberri/repos","events_url":"https://api.github.com/users/iriberri/events{/privacy}","received_events_url":"https://api.github.com/users/iriberri/received_events","type":"User","site_admin":false},"body":"\"MapConfig/template.json\"\r\n-> same than above!","created_at":"2016-03-04T17:02:14Z","updated_at":"2016-03-04T17:02:14Z","html_url":"https://github.com/CartoDB/Windshaft-cartodb/pull/379#discussion_r55056622","pull_request_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379","_links":{"self":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/comments/55056622"},"html":{"href":"https://github.com/CartoDB/Windshaft-cartodb/pull/379#discussion_r55056622"},"pull_request":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379"}}},"pull_request":{"url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379","id":59976610,"html_url":"https://github.com/CartoDB/Windshaft-cartodb/pull/379","diff_url":"https://github.com/CartoDB/Windshaft-cartodb/pull/379.diff","patch_url":"https://github.com/CartoDB/Windshaft-cartodb/pull/379.patch","issue_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/379","number":379,"state":"open","locked":false,"title":"Docs 685 named map tiles and cleanup","user":{"login":"csobier","id":13319925,"avatar_url":"https://avatars.githubusercontent.com/u/13319925?v=3","gravatar_id":"","url":"https://api.github.com/users/csobier","html_url":"https://github.com/csobier","followers_url":"https://api.github.com/users/csobier/followers","following_url":"https://api.github.com/users/csobier/following{/other_user}","gists_url":"https://api.github.com/users/csobier/gists{/gist_id}","starred_url":"https://api.github.com/users/csobier/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/csobier/subscriptions","organizations_url":"https://api.github.com/users/csobier/orgs","repos_url":"https://api.github.com/users/csobier/repos","events_url":"https://api.github.com/users/csobier/events{/privacy}","received_events_url":"https://api.github.com/users/csobier/received_events","type":"User","site_admin":false},"body":"For [Docs issue#678](https://github.com/CartoDB/docs/issues/678). (I know, I used the wrong issue number in the branch name - doh!). This also includes a lot of clean-up effort (consistency of terminology, capitalization, and I interviewed Andy and Michelle in an attempt to add more clarification about the actual usability and workflow).\r\n\r\n@iriberri , I included some comments directly to you in this branch (based on questions from all involved). I anticipate I'll need a few round of edits, but I think it's enough to kick-off the review process. ","created_at":"2016-02-19T16:59:13Z","updated_at":"2016-03-04T17:02:14Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b5d7bf2e2c48dd4499a1a4f6cb7717ddf487f0bd","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379/commits","review_comments_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379/comments","review_comment_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/comments{/number}","comments_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/379/comments","statuses_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/statuses/14f58e12bbf47c79fc216804a4d9e19622cb8514","head":{"label":"CartoDB:docs-685-named-map-tiles-and-cleanup","ref":"docs-685-named-map-tiles-and-cleanup","sha":"14f58e12bbf47c79fc216804a4d9e19622cb8514","user":{"login":"CartoDB","id":1799254,"avatar_url":"https://avatars.githubusercontent.com/u/1799254?v=3","gravatar_id":"","url":"https://api.github.com/users/CartoDB","html_url":"https://github.com/CartoDB","followers_url":"https://api.github.com/users/CartoDB/followers","following_url":"https://api.github.com/users/CartoDB/following{/other_user}","gists_url":"https://api.github.com/users/CartoDB/gists{/gist_id}","starred_url":"https://api.github.com/users/CartoDB/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/CartoDB/subscriptions","organizations_url":"https://api.github.com/users/CartoDB/orgs","repos_url":"https://api.github.com/users/CartoDB/repos","events_url":"https://api.github.com/users/CartoDB/events{/privacy}","received_events_url":"https://api.github.com/users/CartoDB/received_events","type":"Organization","site_admin":false},"repo":{"id":2325416,"name":"Windshaft-cartodb","full_name":"CartoDB/Windshaft-cartodb","owner":{"login":"CartoDB","id":1799254,"avatar_url":"https://avatars.githubusercontent.com/u/1799254?v=3","gravatar_id":"","url":"https://api.github.com/users/CartoDB","html_url":"https://github.com/CartoDB","followers_url":"https://api.github.com/users/CartoDB/followers","following_url":"https://api.github.com/users/CartoDB/following{/other_user}","gists_url":"https://api.github.com/users/CartoDB/gists{/gist_id}","starred_url":"https://api.github.com/users/CartoDB/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/CartoDB/subscriptions","organizations_url":"https://api.github.com/users/CartoDB/orgs","repos_url":"https://api.github.com/users/CartoDB/repos","events_url":"https://api.github.com/users/CartoDB/events{/privacy}","received_events_url":"https://api.github.com/users/CartoDB/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/CartoDB/Windshaft-cartodb","description":"Windshaft tailored for CartoDB","fork":false,"url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb","forks_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/forks","keys_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/keys{/key_id}","collaborators_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/teams","hooks_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/hooks","issue_events_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/events{/number}","events_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/events","assignees_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/assignees{/user}","branches_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/branches{/branch}","tags_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/tags","blobs_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/refs{/sha}","trees_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/trees{/sha}","statuses_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/statuses/{sha}","languages_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/languages","stargazers_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/stargazers","contributors_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/contributors","subscribers_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/subscribers","subscription_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/subscription","commits_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/commits{/sha}","git_commits_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/commits{/sha}","comments_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/comments{/number}","issue_comment_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/comments{/number}","contents_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/contents/{+path}","compare_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/compare/{base}...{head}","merges_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/merges","archive_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/downloads","issues_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues{/number}","pulls_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls{/number}","milestones_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/milestones{/number}","notifications_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/labels{/name}","releases_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/releases{/id}","deployments_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/deployments","created_at":"2011-09-04T23:35:06Z","updated_at":"2016-03-03T09:39:30Z","pushed_at":"2016-03-04T15:20:48Z","git_url":"git://github.com/CartoDB/Windshaft-cartodb.git","ssh_url":"git@github.com:CartoDB/Windshaft-cartodb.git","clone_url":"https://github.com/CartoDB/Windshaft-cartodb.git","svn_url":"https://github.com/CartoDB/Windshaft-cartodb","homepage":"","size":28175,"stargazers_count":33,"watchers_count":33,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":29,"mirror_url":null,"open_issues_count":34,"forks":29,"open_issues":34,"watchers":33,"default_branch":"master"}},"base":{"label":"CartoDB:master","ref":"master","sha":"2ac297441411859a714ef192393d9d159cc5b900","user":{"login":"CartoDB","id":1799254,"avatar_url":"https://avatars.githubusercontent.com/u/1799254?v=3","gravatar_id":"","url":"https://api.github.com/users/CartoDB","html_url":"https://github.com/CartoDB","followers_url":"https://api.github.com/users/CartoDB/followers","following_url":"https://api.github.com/users/CartoDB/following{/other_user}","gists_url":"https://api.github.com/users/CartoDB/gists{/gist_id}","starred_url":"https://api.github.com/users/CartoDB/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/CartoDB/subscriptions","organizations_url":"https://api.github.com/users/CartoDB/orgs","repos_url":"https://api.github.com/users/CartoDB/repos","events_url":"https://api.github.com/users/CartoDB/events{/privacy}","received_events_url":"https://api.github.com/users/CartoDB/received_events","type":"Organization","site_admin":false},"repo":{"id":2325416,"name":"Windshaft-cartodb","full_name":"CartoDB/Windshaft-cartodb","owner":{"login":"CartoDB","id":1799254,"avatar_url":"https://avatars.githubusercontent.com/u/1799254?v=3","gravatar_id":"","url":"https://api.github.com/users/CartoDB","html_url":"https://github.com/CartoDB","followers_url":"https://api.github.com/users/CartoDB/followers","following_url":"https://api.github.com/users/CartoDB/following{/other_user}","gists_url":"https://api.github.com/users/CartoDB/gists{/gist_id}","starred_url":"https://api.github.com/users/CartoDB/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/CartoDB/subscriptions","organizations_url":"https://api.github.com/users/CartoDB/orgs","repos_url":"https://api.github.com/users/CartoDB/repos","events_url":"https://api.github.com/users/CartoDB/events{/privacy}","received_events_url":"https://api.github.com/users/CartoDB/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/CartoDB/Windshaft-cartodb","description":"Windshaft tailored for CartoDB","fork":false,"url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb","forks_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/forks","keys_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/keys{/key_id}","collaborators_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/teams","hooks_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/hooks","issue_events_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/events{/number}","events_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/events","assignees_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/assignees{/user}","branches_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/branches{/branch}","tags_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/tags","blobs_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/refs{/sha}","trees_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/trees{/sha}","statuses_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/statuses/{sha}","languages_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/languages","stargazers_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/stargazers","contributors_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/contributors","subscribers_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/subscribers","subscription_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/subscription","commits_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/commits{/sha}","git_commits_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/git/commits{/sha}","comments_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/comments{/number}","issue_comment_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/comments{/number}","contents_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/contents/{+path}","compare_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/compare/{base}...{head}","merges_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/merges","archive_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/downloads","issues_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues{/number}","pulls_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls{/number}","milestones_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/milestones{/number}","notifications_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/labels{/name}","releases_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/releases{/id}","deployments_url":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/deployments","created_at":"2011-09-04T23:35:06Z","updated_at":"2016-03-03T09:39:30Z","pushed_at":"2016-03-04T15:20:48Z","git_url":"git://github.com/CartoDB/Windshaft-cartodb.git","ssh_url":"git@github.com:CartoDB/Windshaft-cartodb.git","clone_url":"https://github.com/CartoDB/Windshaft-cartodb.git","svn_url":"https://github.com/CartoDB/Windshaft-cartodb","homepage":"","size":28175,"stargazers_count":33,"watchers_count":33,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":29,"mirror_url":null,"open_issues_count":34,"forks":29,"open_issues":34,"watchers":33,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379"},"html":{"href":"https://github.com/CartoDB/Windshaft-cartodb/pull/379"},"issue":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/379"},"comments":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/issues/379/comments"},"review_comments":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379/comments"},"review_comment":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/pulls/379/commits"},"statuses":{"href":"https://api.github.com/repos/CartoDB/Windshaft-cartodb/statuses/14f58e12bbf47c79fc216804a4d9e19622cb8514"}}}}