{"action":"created","issue":{"url":"https://api.github.com/repos/ensime/ensime.github.io/issues/120","repository_url":"https://api.github.com/repos/ensime/ensime.github.io","labels_url":"https://api.github.com/repos/ensime/ensime.github.io/issues/120/labels{/name}","comments_url":"https://api.github.com/repos/ensime/ensime.github.io/issues/120/comments","events_url":"https://api.github.com/repos/ensime/ensime.github.io/issues/120/events","html_url":"https://github.com/ensime/ensime.github.io/issues/120","id":152963396,"number":120,"title":"\"Download\" links are well hidden","user":{"login":"Blaisorblade","id":289960,"avatar_url":"https://avatars.githubusercontent.com/u/289960?v=3","gravatar_id":"","url":"https://api.github.com/users/Blaisorblade","html_url":"https://github.com/Blaisorblade","followers_url":"https://api.github.com/users/Blaisorblade/followers","following_url":"https://api.github.com/users/Blaisorblade/following{/other_user}","gists_url":"https://api.github.com/users/Blaisorblade/gists{/gist_id}","starred_url":"https://api.github.com/users/Blaisorblade/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Blaisorblade/subscriptions","organizations_url":"https://api.github.com/users/Blaisorblade/orgs","repos_url":"https://api.github.com/users/Blaisorblade/repos","events_url":"https://api.github.com/users/Blaisorblade/events{/privacy}","received_events_url":"https://api.github.com/users/Blaisorblade/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2016-05-04T09:01:09Z","updated_at":"2016-05-04T09:02:52Z","closed_at":"2016-05-04T09:02:14Z","body":"Expected behavior: by following obvious links from the Ensime homepage, I figure out how to install it.\r\nActual behavior: http://ensime.github.io/ leads to http://ensime.github.io/getting_started/, and there you're lost.\r\nPath to improvement: I'm short on time, but I'd consider contributing if there's agreement on what should be there — and if, well, you accept there's an issue.\r\n\r\nIn fact, Getting Started does not say how to get started at all, which is (if I'm guessing correctly):\r\n- to create a .ensime file, describing your project layout to Ensime, follow instructions appropriate to the build tool you're using.\r\n- to install the Ensime plugin in your editor, follow instructions appropriate to your editor.\r\n- to install the Ensime server, follow instructions X to install https://github.com/ensime/ensime-server... Or not at all? http://ensime.github.io/editors/emacs/install/ seems to suggest this is not needed?\r\nFrom http://ensime.github.io/contributing/ I can infer this is not needed, apparently, because the Emacs plugin bundles the server...\r\n\r\nThe third step (or the fact it isn't needed) is not mentioned at all there; the first two are very implicits. A new user is not going to figure out either (except by chance).\r\n\r\nIn fact, the installation links are hidden in this paragraph about philosophy:\r\n\r\n> It is important to realise that ENSIME is not an IDE, it is just one tool in a toolbox, following the UNIX philosophy of Do One Thing and Do It Well.\r\n\r\n> - You must be using a build tool that is supported, to generate a .ensime file.\r\n- And you must be using a text editor that is supported, to start and connect to the JVM process.\r\n\r\nMoreover, clicking on either link gets to an ambiguous table. To install Ensime there, you need to click on the \"Learn more\" links.\r\n\r\nInstead of offering information, the webpage should call the user to action."},"comment":{"url":"https://api.github.com/repos/ensime/ensime.github.io/issues/comments/216800268","html_url":"https://github.com/ensime/ensime.github.io/issues/120#issuecomment-216800268","issue_url":"https://api.github.com/repos/ensime/ensime.github.io/issues/120","id":216800268,"user":{"login":"fommil","id":1914041,"avatar_url":"https://avatars.githubusercontent.com/u/1914041?v=3","gravatar_id":"","url":"https://api.github.com/users/fommil","html_url":"https://github.com/fommil","followers_url":"https://api.github.com/users/fommil/followers","following_url":"https://api.github.com/users/fommil/following{/other_user}","gists_url":"https://api.github.com/users/fommil/gists{/gist_id}","starred_url":"https://api.github.com/users/fommil/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fommil/subscriptions","organizations_url":"https://api.github.com/users/fommil/orgs","repos_url":"https://api.github.com/users/fommil/repos","events_url":"https://api.github.com/users/fommil/events{/privacy}","received_events_url":"https://api.github.com/users/fommil/received_events","type":"User","site_admin":false},"created_at":"2016-05-04T09:02:52Z","updated_at":"2016-05-04T09:02:52Z","body":"btw, you shouldn't need a step 3, the client installs the server automatically."}}