{"action":"created","issue":{"url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069","repository_url":"https://api.github.com/repos/PerlDancer/Dancer2","labels_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069/labels{/name}","comments_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069/comments","events_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069/events","html_url":"https://github.com/PerlDancer/Dancer2/pull/1069","id":121190608,"number":1069,"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},"labels":[{"url":"https://api.github.com/repos/PerlDancer/Dancer2/labels/Documentation","name":"Documentation","color":"bfdadc"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":22,"created_at":"2015-12-09T09:03:01Z","updated_at":"2016-05-26T10:38:18Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/PerlDancer/Dancer2/pulls/1069","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"},"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)."},"comment":{"url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/comments/221836957","html_url":"https://github.com/PerlDancer/Dancer2/pull/1069#issuecomment-221836957","issue_url":"https://api.github.com/repos/PerlDancer/Dancer2/issues/1069","id":221836957,"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},"created_at":"2016-05-26T10:38:18Z","updated_at":"2016-05-26T10:38:18Z","body":"I find the example code in the tutorial not very enticing, also it may lead people on the wrong path (code on their own instead using DBIC / DPAE). So I'm fine with removing that as well.\r\n\r\nOtherwise I agree with the deprecation."}}
{"actor":{"display_login":"racke"}}