{"action":"created","issue":{"url":"https://api.github.com/repos/picocms/Pico/issues/276","labels_url":"https://api.github.com/repos/picocms/Pico/issues/276/labels{/name}","comments_url":"https://api.github.com/repos/picocms/Pico/issues/276/comments","events_url":"https://api.github.com/repos/picocms/Pico/issues/276/events","html_url":"https://github.com/picocms/Pico/pull/276","id":116947742,"number":276,"title":"Restructured upgrade.md","user":{"login":"smcdougall","id":12779160,"avatar_url":"https://avatars.githubusercontent.com/u/12779160?v=3","gravatar_id":"","url":"https://api.github.com/users/smcdougall","html_url":"https://github.com/smcdougall","followers_url":"https://api.github.com/users/smcdougall/followers","following_url":"https://api.github.com/users/smcdougall/following{/other_user}","gists_url":"https://api.github.com/users/smcdougall/gists{/gist_id}","starred_url":"https://api.github.com/users/smcdougall/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/smcdougall/subscriptions","organizations_url":"https://api.github.com/users/smcdougall/orgs","repos_url":"https://api.github.com/users/smcdougall/repos","events_url":"https://api.github.com/users/smcdougall/events{/privacy}","received_events_url":"https://api.github.com/users/smcdougall/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/picocms/Pico/labels/info:%20Feedback%20needed","name":"info: Feedback needed","color":"006b75"},{"url":"https://api.github.com/repos/picocms/Pico/labels/pri:%20High","name":"pri: High","color":"e11d21"},{"url":"https://api.github.com/repos/picocms/Pico/labels/status:%20In-Progress","name":"status: In-Progress","color":"c7def8"},{"url":"https://api.github.com/repos/picocms/Pico/labels/type:%20Feature","name":"type: Feature","color":"009800"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/picocms/Pico/milestones/2","html_url":"https://github.com/picocms/Pico/milestones/Version%201.0.0","labels_url":"https://api.github.com/repos/picocms/Pico/milestones/2/labels","id":1389297,"number":2,"title":"Version 1.0.0","description":"Complete these issues before release of version 1.0.0","creator":{"login":"theshka","id":640217,"avatar_url":"https://avatars.githubusercontent.com/u/640217?v=3","gravatar_id":"","url":"https://api.github.com/users/theshka","html_url":"https://github.com/theshka","followers_url":"https://api.github.com/users/theshka/followers","following_url":"https://api.github.com/users/theshka/following{/other_user}","gists_url":"https://api.github.com/users/theshka/gists{/gist_id}","starred_url":"https://api.github.com/users/theshka/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/theshka/subscriptions","organizations_url":"https://api.github.com/users/theshka/orgs","repos_url":"https://api.github.com/users/theshka/repos","events_url":"https://api.github.com/users/theshka/events{/privacy}","received_events_url":"https://api.github.com/users/theshka/received_events","type":"User","site_admin":false},"open_issues":3,"closed_issues":2,"state":"open","created_at":"2015-11-02T16:09:37Z","updated_at":"2015-11-14T21:07:06Z","due_on":null,"closed_at":null},"comments":4,"created_at":"2015-11-14T19:34:53Z","updated_at":"2015-11-14T23:13:51Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/picocms/Pico/pulls/276","html_url":"https://github.com/picocms/Pico/pull/276","diff_url":"https://github.com/picocms/Pico/pull/276.diff","patch_url":"https://github.com/picocms/Pico/pull/276.patch"},"body":"Restructured upgrade.md to be more readable.  It's still a work in progress, and the content needs to be refined a bit more."},"comment":{"url":"https://api.github.com/repos/picocms/Pico/issues/comments/156756371","html_url":"https://github.com/picocms/Pico/pull/276#issuecomment-156756371","issue_url":"https://api.github.com/repos/picocms/Pico/issues/276","id":156756371,"user":{"login":"PhrozenByte","id":920356,"avatar_url":"https://avatars.githubusercontent.com/u/920356?v=3","gravatar_id":"","url":"https://api.github.com/users/PhrozenByte","html_url":"https://github.com/PhrozenByte","followers_url":"https://api.github.com/users/PhrozenByte/followers","following_url":"https://api.github.com/users/PhrozenByte/following{/other_user}","gists_url":"https://api.github.com/users/PhrozenByte/gists{/gist_id}","starred_url":"https://api.github.com/users/PhrozenByte/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PhrozenByte/subscriptions","organizations_url":"https://api.github.com/users/PhrozenByte/orgs","repos_url":"https://api.github.com/users/PhrozenByte/repos","events_url":"https://api.github.com/users/PhrozenByte/events{/privacy}","received_events_url":"https://api.github.com/users/PhrozenByte/received_events","type":"User","site_admin":false},"created_at":"2015-11-14T23:13:51Z","updated_at":"2015-11-14T23:13:51Z","body":"Yeah, you summarized pretty well what I personally see as a \"ordinary user\". However, @theshka and @picocms don't necessarily share my opinion :smile:\r\n\r\nMaybe we should go with your idea of having three distinct and equally entitled sections. The first section addresses everything a \"I'm neither creating custom plugins nor themes\"-user needs to know, the second section addresses everything a \"I have my custom theme\"-user needs to know and the third section includes the \"under the hood\" changes. The latter will be extended by the dev docs (`_plugin-dev/upgrade.md`). I don't know how these sections should be named (neither \"How to upgrade\" nor \"What's new\" fit...), maybe someone has a good idea...\r\n\r\nEnsuing from the old `upgrade.md` ([this one](http://picocms.org/upgrade.html)), the first section is basically the [\"How to upgrade\" section](http://picocms.org/upgrade.html#how-to-upgrade) without its sub-sections plus the [\"Ensure restricted access\" section](http://picocms.org/upgrade.html#ensure-restricted-access-to-content-directory) and the part of the [\"Routing system\" section](http://picocms.org/upgrade.html#routing-system) talking about Markdown files. The second section basically consists of the [remaining](http://picocms.org/upgrade.html#drop-of--pagecontent--and-the-new-picoparsepagescontent-plugin) [contents](http://picocms.org/upgrade.html#drop-of--pageexcerpt--and-the-new-picoexcerpt-plugin) and the other half of the [\"Routing system\" section](http://picocms.org/upgrade.html#routing-system). The third section needs to be added.\r\n\r\nDo you think this is a good plan? :smiley:\r\nbtw @theshka, what do you think about this?"}}