{"action":"created","issue":{"url":"https://api.github.com/repos/exercism/exercism.io/issues/2095","labels_url":"https://api.github.com/repos/exercism/exercism.io/issues/2095/labels{/name}","comments_url":"https://api.github.com/repos/exercism/exercism.io/issues/2095/comments","events_url":"https://api.github.com/repos/exercism/exercism.io/issues/2095/events","html_url":"https://github.com/exercism/exercism.io/issues/2095","id":50980677,"number":2095,"title":"How to set up a local dev environment","user":{"login":"kytrinyx","id":276834,"avatar_url":"https://avatars.githubusercontent.com/u/276834?v=3","gravatar_id":"","url":"https://api.github.com/users/kytrinyx","html_url":"https://github.com/kytrinyx","followers_url":"https://api.github.com/users/kytrinyx/followers","following_url":"https://api.github.com/users/kytrinyx/following{/other_user}","gists_url":"https://api.github.com/users/kytrinyx/gists{/gist_id}","starred_url":"https://api.github.com/users/kytrinyx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kytrinyx/subscriptions","organizations_url":"https://api.github.com/users/kytrinyx/orgs","repos_url":"https://api.github.com/users/kytrinyx/repos","events_url":"https://api.github.com/users/kytrinyx/events{/privacy}","received_events_url":"https://api.github.com/users/kytrinyx/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/exercism/exercism.io/labels/operation%20welcome","name":"operation welcome","color":"0A6F3C"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2014-12-04T14:22:57Z","updated_at":"2015-03-05T21:48:15Z","closed_at":null,"body":"See Issue #2092 for an overview of operation welcome contributors.\r\n\r\n-----------------------\r\n\r\nAt the moment the README contains a list of steps to perform, but very little context outside of that. Also, the README probably only works for Mac, can perhaps be used with Linux, and almost certainly does not work on Windows.\r\n\r\nAdditionally, each language track should have a \"how to contribute\" section in the README.\r\n\r\nFrom the [OpenHatch guide](http://opensource-events.com/#project-setup):\r\n\r\n> Here are common elements of setting up a development environment you’ll want your guide to address:\r\n\r\n> **Preparing their computer**\r\n> Make sure they’re familiar with their operating system’s tools, such as the terminal/command prompt. You can do this by linking to a tutorial and asking contributors to make sure they understand it. There are usually great tutorials already out there - OpenHatch’s command line tutorial can be found here.\r\n> If contributors need to set up a virtual environment, access a virtual machine, or download a specific development kit, give them instructions on how to do so.\r\n> List any dependencies needed to run your project, and how to install them. If there are good installation guides for those dependencies, link to them.\r\n> \r\n> **Downloading the source**\r\n> Give detailed instructions on how to download the source of the project, including common missteps or obstacles.\r\n>\r\n> **How to view/test changes**\r\n> Give instructions on how to view and test the changes they’ve made. This may vary depending on what they’ve changed, but do your best to cover common changes. This can be as simple as viewing an html document in a browser, but may be more complicated.\r\n>\r\n> Installation will often differ depending on the operating system of the contributor. You will probably need to create separate instructions in various parts of your guide for Windows, Mac and Linux users. If you only want to support development on a single operating system, make sure that is clear to users, ideally in the top-level documentation."},"comment":{"url":"https://api.github.com/repos/exercism/exercism.io/issues/comments/77459307","html_url":"https://github.com/exercism/exercism.io/issues/2095#issuecomment-77459307","issue_url":"https://api.github.com/repos/exercism/exercism.io/issues/2095","id":77459307,"user":{"login":"KaoruDev","id":5273755,"avatar_url":"https://avatars.githubusercontent.com/u/5273755?v=3","gravatar_id":"","url":"https://api.github.com/users/KaoruDev","html_url":"https://github.com/KaoruDev","followers_url":"https://api.github.com/users/KaoruDev/followers","following_url":"https://api.github.com/users/KaoruDev/following{/other_user}","gists_url":"https://api.github.com/users/KaoruDev/gists{/gist_id}","starred_url":"https://api.github.com/users/KaoruDev/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/KaoruDev/subscriptions","organizations_url":"https://api.github.com/users/KaoruDev/orgs","repos_url":"https://api.github.com/users/KaoruDev/repos","events_url":"https://api.github.com/users/KaoruDev/events{/privacy}","received_events_url":"https://api.github.com/users/KaoruDev/received_events","type":"User","site_admin":false},"created_at":"2015-03-05T21:48:15Z","updated_at":"2015-03-05T21:48:15Z","body":"> very little context outside of that\r\n\r\nWhat else should be mentioned?"}}