{"action":"created","comment":{"url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/comments/58857563","id":58857563,"diff_hunk":"@@ -115,102 +115,1022 @@ __END__\n \n =encoding UTF-8\n \n+=head1 SYNOPSIS\n+\n+    get '/' => sub { 'Hello, world!' };\n+\n =head1 DESCRIPTION\n \n-Dancer2 is the new generation of L<Dancer>, the lightweight web-framework for\n-Perl. Dancer2 is a complete rewrite based on L<Moo>.\n+Dancer2 is a lightweight micro web framework for Perl. It is the new\n+generation of L<Dancer> and replaces L<Dancer>.\n+\n+If you are converting a L<Dancer> application to L<Dancer2>, the\n+L<Dancer2::Manual::Migration> document covers the changes you might","path":"lib/Dancer2.pm","position":16,"original_position":16,"commit_id":"397900f3b368e99087e69eceda9e276cd31a2252","original_commit_id":"397900f3b368e99087e69eceda9e276cd31a2252","user":{"login":"racke","id":143678,"avatar_url":"https://avatars.githubusercontent.com/u/143678?v=3","gravatar_id":"","url":"https://api.github.com/users/racke","html_url":"https://github.com/racke","followers_url":"https://api.github.com/users/racke/followers","following_url":"https://api.github.com/users/racke/following{/other_user}","gists_url":"https://api.github.com/users/racke/gists{/gist_id}","starred_url":"https://api.github.com/users/racke/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/racke/subscriptions","organizations_url":"https://api.github.com/users/racke/orgs","repos_url":"https://api.github.com/users/racke/repos","events_url":"https://api.github.com/users/racke/events{/privacy}","received_events_url":"https://api.github.com/users/racke/received_events","type":"User","site_admin":false},"body":"On 04/07/2016 01:36 PM, Sawyer X wrote:\n> In lib/Dancer2.pm <https://github.com/PerlDancer/Dancer2/pull/1069#discussion_r58856895>:\n> \n>>  =head1 DESCRIPTION\n>>  \n>> -Dancer2 is the new generation of L<Dancer>, the lightweight web-framework for\n>> -Perl. Dancer2 is a complete rewrite based on L<Moo>.\n>> +Dancer2 is a lightweight micro web framework for Perl. It is the new\n>> +generation of L<Dancer> and replaces L<Dancer>.\n>> +\n>> +If you are converting a L<Dancer> application to L<Dancer2>, the\n>> +L<Dancer2::Manual::Migration> document covers the changes you might\n> \n> I'm not sure every app actually needs updating. I don't want to make an assumption about it.\n\nAt the very least you need to replace Dancer with Dancer2 :-).\n\nRegards\n          Racke\n\n\n-- \nPerl and Dancer Development\n\n\n","created_at":"2016-04-07T11:42:55Z","updated_at":"2016-04-07T11:42:55Z","html_url":"https://github.com/PerlDancer/Dancer2/pull/1069#discussion_r58857563","pull_request_url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069","_links":{"self":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/comments/58857563"},"html":{"href":"https://github.com/PerlDancer/Dancer2/pull/1069#discussion_r58857563"},"pull_request":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069"}}},"pull_request":{"url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069","id":53092136,"html_url":"https://github.com/PerlDancer/Dancer2/pull/1069","diff_url":"https://github.com/PerlDancer/Dancer2/pull/1069.diff","patch_url":"https://github.com/PerlDancer/Dancer2/pull/1069.patch","issue_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069","number":1069,"state":"open","locked":false,"title":"New documentation draft:","user":{"login":"xsawyerx","id":54725,"avatar_url":"https://avatars.githubusercontent.com/u/54725?v=3","gravatar_id":"","url":"https://api.github.com/users/xsawyerx","html_url":"https://github.com/xsawyerx","followers_url":"https://api.github.com/users/xsawyerx/followers","following_url":"https://api.github.com/users/xsawyerx/following{/other_user}","gists_url":"https://api.github.com/users/xsawyerx/gists{/gist_id}","starred_url":"https://api.github.com/users/xsawyerx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xsawyerx/subscriptions","organizations_url":"https://api.github.com/users/xsawyerx/orgs","repos_url":"https://api.github.com/users/xsawyerx/repos","events_url":"https://api.github.com/users/xsawyerx/events{/privacy}","received_events_url":"https://api.github.com/users/xsawyerx/received_events","type":"User","site_admin":false},"body":"Docs are hard. We currently have the Introduction, the Tutorial,\r\nthe Manual, and the Cookbook. It's hard to tell what is documented\r\nwhere.\r\n\r\nThe idea was that the Introduction explains things gently,\r\nthe Tutorial walks you through writing an application, the Manual\r\nprovides the complete coverage, and the Cookbook provides all the\r\ntips, tricks, and hints collected by developers (based heavily\r\non contributor input).\r\n\r\nI think the problem is mainly that we do not have a base-line for\r\nwhat skills you need in order to understand Dancer and how to use\r\nit. This means we have multiple places to start from, but they\r\nare not clear. Each one tries to cater to multiple different\r\ncrowds.\r\n\r\nWhat @mickeyn and I wanted to create was a simple guide that,\r\nassuming you know basic HTTP and Perl, explains the structure of\r\nthe Dancer system: the Apps, the routing, the hooks, etc.\r\n\r\nStarting from the ground up, this documentation is relatively\r\nthin but is able to not only cover a large and significant portion\r\nof the keywords, it also captures how Dancer works, and how its\r\nstructured internally (to an extent).","created_at":"2015-12-09T09:03:01Z","updated_at":"2016-04-07T11:42:55Z","closed_at":null,"merged_at":null,"merge_commit_sha":"255550f8056addf9a568569c51808d1907261e37","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069/commits","review_comments_url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069/comments","review_comment_url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/comments{/number}","comments_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069/comments","statuses_url":"https://api.github.com/repos/PerlDancer/Dancer2/statuses/397900f3b368e99087e69eceda9e276cd31a2252","head":{"label":"PerlDancer:docs/from-scratch","ref":"docs/from-scratch","sha":"397900f3b368e99087e69eceda9e276cd31a2252","user":{"login":"PerlDancer","id":409763,"avatar_url":"https://avatars.githubusercontent.com/u/409763?v=3","gravatar_id":"","url":"https://api.github.com/users/PerlDancer","html_url":"https://github.com/PerlDancer","followers_url":"https://api.github.com/users/PerlDancer/followers","following_url":"https://api.github.com/users/PerlDancer/following{/other_user}","gists_url":"https://api.github.com/users/PerlDancer/gists{/gist_id}","starred_url":"https://api.github.com/users/PerlDancer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PerlDancer/subscriptions","organizations_url":"https://api.github.com/users/PerlDancer/orgs","repos_url":"https://api.github.com/users/PerlDancer/repos","events_url":"https://api.github.com/users/PerlDancer/events{/privacy}","received_events_url":"https://api.github.com/users/PerlDancer/received_events","type":"Organization","site_admin":false},"repo":{"id":2488436,"name":"Dancer2","full_name":"PerlDancer/Dancer2","owner":{"login":"PerlDancer","id":409763,"avatar_url":"https://avatars.githubusercontent.com/u/409763?v=3","gravatar_id":"","url":"https://api.github.com/users/PerlDancer","html_url":"https://github.com/PerlDancer","followers_url":"https://api.github.com/users/PerlDancer/followers","following_url":"https://api.github.com/users/PerlDancer/following{/other_user}","gists_url":"https://api.github.com/users/PerlDancer/gists{/gist_id}","starred_url":"https://api.github.com/users/PerlDancer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PerlDancer/subscriptions","organizations_url":"https://api.github.com/users/PerlDancer/orgs","repos_url":"https://api.github.com/users/PerlDancer/repos","events_url":"https://api.github.com/users/PerlDancer/events{/privacy}","received_events_url":"https://api.github.com/users/PerlDancer/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/PerlDancer/Dancer2","description":"Perl Dancer Next Generation (rewrite of Perl Dancer)","fork":false,"url":"https://api.github.com/repos/PerlDancer/Dancer2","forks_url":"https://api.github.com/repos/PerlDancer/Dancer2/forks","keys_url":"https://api.github.com/repos/PerlDancer/Dancer2/keys{/key_id}","collaborators_url":"https://api.github.com/repos/PerlDancer/Dancer2/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/PerlDancer/Dancer2/teams","hooks_url":"https://api.github.com/repos/PerlDancer/Dancer2/hooks","issue_events_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/events{/number}","events_url":"https://api.github.com/repos/PerlDancer/Dancer2/events","assignees_url":"https://api.github.com/repos/PerlDancer/Dancer2/assignees{/user}","branches_url":"https://api.github.com/repos/PerlDancer/Dancer2/branches{/branch}","tags_url":"https://api.github.com/repos/PerlDancer/Dancer2/tags","blobs_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/refs{/sha}","trees_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/trees{/sha}","statuses_url":"https://api.github.com/repos/PerlDancer/Dancer2/statuses/{sha}","languages_url":"https://api.github.com/repos/PerlDancer/Dancer2/languages","stargazers_url":"https://api.github.com/repos/PerlDancer/Dancer2/stargazers","contributors_url":"https://api.github.com/repos/PerlDancer/Dancer2/contributors","subscribers_url":"https://api.github.com/repos/PerlDancer/Dancer2/subscribers","subscription_url":"https://api.github.com/repos/PerlDancer/Dancer2/subscription","commits_url":"https://api.github.com/repos/PerlDancer/Dancer2/commits{/sha}","git_commits_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/commits{/sha}","comments_url":"https://api.github.com/repos/PerlDancer/Dancer2/comments{/number}","issue_comment_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/comments{/number}","contents_url":"https://api.github.com/repos/PerlDancer/Dancer2/contents/{+path}","compare_url":"https://api.github.com/repos/PerlDancer/Dancer2/compare/{base}...{head}","merges_url":"https://api.github.com/repos/PerlDancer/Dancer2/merges","archive_url":"https://api.github.com/repos/PerlDancer/Dancer2/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/PerlDancer/Dancer2/downloads","issues_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues{/number}","pulls_url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls{/number}","milestones_url":"https://api.github.com/repos/PerlDancer/Dancer2/milestones{/number}","notifications_url":"https://api.github.com/repos/PerlDancer/Dancer2/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/PerlDancer/Dancer2/labels{/name}","releases_url":"https://api.github.com/repos/PerlDancer/Dancer2/releases{/id}","deployments_url":"https://api.github.com/repos/PerlDancer/Dancer2/deployments","created_at":"2011-09-30T10:26:56Z","updated_at":"2016-04-07T09:00:55Z","pushed_at":"2016-04-05T16:40:55Z","git_url":"git://github.com/PerlDancer/Dancer2.git","ssh_url":"git@github.com:PerlDancer/Dancer2.git","clone_url":"https://github.com/PerlDancer/Dancer2.git","svn_url":"https://github.com/PerlDancer/Dancer2","homepage":"http://perldancer.org/","size":7384,"stargazers_count":330,"watchers_count":330,"language":"Perl","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":190,"mirror_url":null,"open_issues_count":106,"forks":190,"open_issues":106,"watchers":330,"default_branch":"master"}},"base":{"label":"PerlDancer:master","ref":"master","sha":"582726da7d30e10513995483bf4666100f6bb6c0","user":{"login":"PerlDancer","id":409763,"avatar_url":"https://avatars.githubusercontent.com/u/409763?v=3","gravatar_id":"","url":"https://api.github.com/users/PerlDancer","html_url":"https://github.com/PerlDancer","followers_url":"https://api.github.com/users/PerlDancer/followers","following_url":"https://api.github.com/users/PerlDancer/following{/other_user}","gists_url":"https://api.github.com/users/PerlDancer/gists{/gist_id}","starred_url":"https://api.github.com/users/PerlDancer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PerlDancer/subscriptions","organizations_url":"https://api.github.com/users/PerlDancer/orgs","repos_url":"https://api.github.com/users/PerlDancer/repos","events_url":"https://api.github.com/users/PerlDancer/events{/privacy}","received_events_url":"https://api.github.com/users/PerlDancer/received_events","type":"Organization","site_admin":false},"repo":{"id":2488436,"name":"Dancer2","full_name":"PerlDancer/Dancer2","owner":{"login":"PerlDancer","id":409763,"avatar_url":"https://avatars.githubusercontent.com/u/409763?v=3","gravatar_id":"","url":"https://api.github.com/users/PerlDancer","html_url":"https://github.com/PerlDancer","followers_url":"https://api.github.com/users/PerlDancer/followers","following_url":"https://api.github.com/users/PerlDancer/following{/other_user}","gists_url":"https://api.github.com/users/PerlDancer/gists{/gist_id}","starred_url":"https://api.github.com/users/PerlDancer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PerlDancer/subscriptions","organizations_url":"https://api.github.com/users/PerlDancer/orgs","repos_url":"https://api.github.com/users/PerlDancer/repos","events_url":"https://api.github.com/users/PerlDancer/events{/privacy}","received_events_url":"https://api.github.com/users/PerlDancer/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/PerlDancer/Dancer2","description":"Perl Dancer Next Generation (rewrite of Perl Dancer)","fork":false,"url":"https://api.github.com/repos/PerlDancer/Dancer2","forks_url":"https://api.github.com/repos/PerlDancer/Dancer2/forks","keys_url":"https://api.github.com/repos/PerlDancer/Dancer2/keys{/key_id}","collaborators_url":"https://api.github.com/repos/PerlDancer/Dancer2/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/PerlDancer/Dancer2/teams","hooks_url":"https://api.github.com/repos/PerlDancer/Dancer2/hooks","issue_events_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/events{/number}","events_url":"https://api.github.com/repos/PerlDancer/Dancer2/events","assignees_url":"https://api.github.com/repos/PerlDancer/Dancer2/assignees{/user}","branches_url":"https://api.github.com/repos/PerlDancer/Dancer2/branches{/branch}","tags_url":"https://api.github.com/repos/PerlDancer/Dancer2/tags","blobs_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/refs{/sha}","trees_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/trees{/sha}","statuses_url":"https://api.github.com/repos/PerlDancer/Dancer2/statuses/{sha}","languages_url":"https://api.github.com/repos/PerlDancer/Dancer2/languages","stargazers_url":"https://api.github.com/repos/PerlDancer/Dancer2/stargazers","contributors_url":"https://api.github.com/repos/PerlDancer/Dancer2/contributors","subscribers_url":"https://api.github.com/repos/PerlDancer/Dancer2/subscribers","subscription_url":"https://api.github.com/repos/PerlDancer/Dancer2/subscription","commits_url":"https://api.github.com/repos/PerlDancer/Dancer2/commits{/sha}","git_commits_url":"https://api.github.com/repos/PerlDancer/Dancer2/git/commits{/sha}","comments_url":"https://api.github.com/repos/PerlDancer/Dancer2/comments{/number}","issue_comment_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/comments{/number}","contents_url":"https://api.github.com/repos/PerlDancer/Dancer2/contents/{+path}","compare_url":"https://api.github.com/repos/PerlDancer/Dancer2/compare/{base}...{head}","merges_url":"https://api.github.com/repos/PerlDancer/Dancer2/merges","archive_url":"https://api.github.com/repos/PerlDancer/Dancer2/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/PerlDancer/Dancer2/downloads","issues_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues{/number}","pulls_url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls{/number}","milestones_url":"https://api.github.com/repos/PerlDancer/Dancer2/milestones{/number}","notifications_url":"https://api.github.com/repos/PerlDancer/Dancer2/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/PerlDancer/Dancer2/labels{/name}","releases_url":"https://api.github.com/repos/PerlDancer/Dancer2/releases{/id}","deployments_url":"https://api.github.com/repos/PerlDancer/Dancer2/deployments","created_at":"2011-09-30T10:26:56Z","updated_at":"2016-04-07T09:00:55Z","pushed_at":"2016-04-05T16:40:55Z","git_url":"git://github.com/PerlDancer/Dancer2.git","ssh_url":"git@github.com:PerlDancer/Dancer2.git","clone_url":"https://github.com/PerlDancer/Dancer2.git","svn_url":"https://github.com/PerlDancer/Dancer2","homepage":"http://perldancer.org/","size":7384,"stargazers_count":330,"watchers_count":330,"language":"Perl","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":190,"mirror_url":null,"open_issues_count":106,"forks":190,"open_issues":106,"watchers":330,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069"},"html":{"href":"https://github.com/PerlDancer/Dancer2/pull/1069"},"issue":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069"},"comments":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069/comments"},"review_comments":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069/comments"},"review_comment":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069/commits"},"statuses":{"href":"https://api.github.com/repos/PerlDancer/Dancer2/statuses/397900f3b368e99087e69eceda9e276cd31a2252"}}}}