{"action":"created","issue":{"url":"https://api.github.com/repos/girder/girder/issues/2222","repository_url":"https://api.github.com/repos/girder/girder","labels_url":"https://api.github.com/repos/girder/girder/issues/2222/labels{/name}","comments_url":"https://api.github.com/repos/girder/girder/issues/2222/comments","events_url":"https://api.github.com/repos/girder/girder/issues/2222/events","html_url":"https://github.com/girder/girder/pull/2222","id":245886557,"node_id":"MDExOlB1bGxSZXF1ZXN0MTMyNjM4NDQ2","number":2222,"title":"Update system prerequisite installation docs","user":{"login":"brianhelba","id":1282879,"node_id":"MDQ6VXNlcjEyODI4Nzk=","avatar_url":"https://avatars1.githubusercontent.com/u/1282879?v=4","gravatar_id":"","url":"https://api.github.com/users/brianhelba","html_url":"https://github.com/brianhelba","followers_url":"https://api.github.com/users/brianhelba/followers","following_url":"https://api.github.com/users/brianhelba/following{/other_user}","gists_url":"https://api.github.com/users/brianhelba/gists{/gist_id}","starred_url":"https://api.github.com/users/brianhelba/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brianhelba/subscriptions","organizations_url":"https://api.github.com/users/brianhelba/orgs","repos_url":"https://api.github.com/users/brianhelba/repos","events_url":"https://api.github.com/users/brianhelba/events{/privacy}","received_events_url":"https://api.github.com/users/brianhelba/received_events","type":"User","site_admin":false},"labels":[{"id":105911031,"node_id":"MDU6TGFiZWwxMDU5MTEwMzE=","url":"https://api.github.com/repos/girder/girder/labels/domain:%20docs","name":"domain: docs","color":"bfd4f2","default":false}],"state":"open","locked":false,"assignee":{"login":"brianhelba","id":1282879,"node_id":"MDQ6VXNlcjEyODI4Nzk=","avatar_url":"https://avatars1.githubusercontent.com/u/1282879?v=4","gravatar_id":"","url":"https://api.github.com/users/brianhelba","html_url":"https://github.com/brianhelba","followers_url":"https://api.github.com/users/brianhelba/followers","following_url":"https://api.github.com/users/brianhelba/following{/other_user}","gists_url":"https://api.github.com/users/brianhelba/gists{/gist_id}","starred_url":"https://api.github.com/users/brianhelba/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brianhelba/subscriptions","organizations_url":"https://api.github.com/users/brianhelba/orgs","repos_url":"https://api.github.com/users/brianhelba/repos","events_url":"https://api.github.com/users/brianhelba/events{/privacy}","received_events_url":"https://api.github.com/users/brianhelba/received_events","type":"User","site_admin":false},"assignees":[{"login":"brianhelba","id":1282879,"node_id":"MDQ6VXNlcjEyODI4Nzk=","avatar_url":"https://avatars1.githubusercontent.com/u/1282879?v=4","gravatar_id":"","url":"https://api.github.com/users/brianhelba","html_url":"https://github.com/brianhelba","followers_url":"https://api.github.com/users/brianhelba/followers","following_url":"https://api.github.com/users/brianhelba/following{/other_user}","gists_url":"https://api.github.com/users/brianhelba/gists{/gist_id}","starred_url":"https://api.github.com/users/brianhelba/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brianhelba/subscriptions","organizations_url":"https://api.github.com/users/brianhelba/orgs","repos_url":"https://api.github.com/users/brianhelba/repos","events_url":"https://api.github.com/users/brianhelba/events{/privacy}","received_events_url":"https://api.github.com/users/brianhelba/received_events","type":"User","site_admin":false}],"milestone":null,"comments":5,"created_at":"2017-07-26T23:46:28Z","updated_at":"2018-06-15T04:14:51Z","closed_at":null,"author_association":"MEMBER","pull_request":{"url":"https://api.github.com/repos/girder/girder/pulls/2222","html_url":"https://github.com/girder/girder/pull/2222","diff_url":"https://github.com/girder/girder/pull/2222.diff","patch_url":"https://github.com/girder/girder/pull/2222.patch"},"body":"This brings the system prerequisite installation docs up to date with the actual requirements of Girder, and reorganizes them to be easier to follow.\r\n\r\nIt also drops the explicit installation docs for Windows, Debian, and Arch Linux because:\r\n* Bare-metal installation on Windows is far too unstable. Better alternatives (Docker and Virtualbox) exist for that platform.\r\n* The Arch Linux docs were incomplete.\r\n* Debian and Arch Linux are untested and used by a smaller minority of real-world platforms. Also, since those distributions require more advanced Linux skills to install and maintain, users would *tend* to be more sophisticated and able to follow upstream installation docs.\r\n\r\nAs @danlamanna pointed out, it's an inherent liability to maintain documentation on how to install third-party software, as it must be kept up to date. However, I think there's enough value in lowering the barriers to entry (particularly for non-software developer users) for installing Girder on the bare-metal of common platforms that the docs should stay, but be no more complex or verbose than necessary.\r\n\r\nFinally, note that a future PR will add documentation for installation via Docker and Vagrant, which should probably be the preferred solutions for new users.\r\n\r\nThis is building at: https://girder.readthedocs.io/en/install-docs/"},"comment":{"url":"https://api.github.com/repos/girder/girder/issues/comments/397508600","html_url":"https://github.com/girder/girder/pull/2222#issuecomment-397508600","issue_url":"https://api.github.com/repos/girder/girder/issues/2222","id":397508600,"node_id":"MDEyOklzc3VlQ29tbWVudDM5NzUwODYwMA==","user":{"login":"brianhelba","id":1282879,"node_id":"MDQ6VXNlcjEyODI4Nzk=","avatar_url":"https://avatars1.githubusercontent.com/u/1282879?v=4","gravatar_id":"","url":"https://api.github.com/users/brianhelba","html_url":"https://github.com/brianhelba","followers_url":"https://api.github.com/users/brianhelba/followers","following_url":"https://api.github.com/users/brianhelba/following{/other_user}","gists_url":"https://api.github.com/users/brianhelba/gists{/gist_id}","starred_url":"https://api.github.com/users/brianhelba/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brianhelba/subscriptions","organizations_url":"https://api.github.com/users/brianhelba/orgs","repos_url":"https://api.github.com/users/brianhelba/repos","events_url":"https://api.github.com/users/brianhelba/events{/privacy}","received_events_url":"https://api.github.com/users/brianhelba/received_events","type":"User","site_admin":false},"created_at":"2018-06-15T04:14:51Z","updated_at":"2018-06-15T04:14:51Z","author_association":"MEMBER","body":"@danlamanna Per our discussion, I've split the prerequisites into dependencies and installation quickstart pages.\r\n\r\nAlso, see my comment in #2286 regarding a path forward on Python 3.\r\n\r\nThis is now ready for review."}}
{"actor":{"display_login":"brianhelba"}}