{"action":"created","issue":{"url":"https://api.github.com/repos/olivere/elastic/issues/55","labels_url":"https://api.github.com/repos/olivere/elastic/issues/55/labels{/name}","comments_url":"https://api.github.com/repos/olivere/elastic/issues/55/comments","events_url":"https://api.github.com/repos/olivere/elastic/issues/55/events","html_url":"https://github.com/olivere/elastic/issues/55","id":64009946,"number":55,"title":"Standardize which repo to use","user":{"login":"ysimonson","id":127386,"avatar_url":"https://avatars.githubusercontent.com/u/127386?v=3","gravatar_id":"","url":"https://api.github.com/users/ysimonson","html_url":"https://github.com/ysimonson","followers_url":"https://api.github.com/users/ysimonson/followers","following_url":"https://api.github.com/users/ysimonson/following{/other_user}","gists_url":"https://api.github.com/users/ysimonson/gists{/gist_id}","starred_url":"https://api.github.com/users/ysimonson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ysimonson/subscriptions","organizations_url":"https://api.github.com/users/ysimonson/orgs","repos_url":"https://api.github.com/users/ysimonson/repos","events_url":"https://api.github.com/users/ysimonson/events{/privacy}","received_events_url":"https://api.github.com/users/ysimonson/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-03-24T14:31:44Z","updated_at":"2015-03-25T21:54:05Z","closed_at":"2015-03-24T18:11:15Z","body":"The linked documentation is for github.com/olivere/elastic, but the instructions are for installing gopkg.in/olivere/elastic.v1, and there's substantial differences between the two.\r\n\r\nThis threw me off for a while because I was trying to reference functions in the github repo, and used in unit tests, but missing from the gopkg repo. In hindsight it's obvious, but after having used the lib for a few days, I totally forgot I was't using the github repo. I think this will likewise throw people off who don't know what gopkg is.\r\n\r\nHow about referencing the same repo for both docs and installation instructions, and then adding a note about the existence of the other?\r\n"},"comment":{"url":"https://api.github.com/repos/olivere/elastic/issues/comments/86230039","html_url":"https://github.com/olivere/elastic/issues/55#issuecomment-86230039","issue_url":"https://api.github.com/repos/olivere/elastic/issues/55","id":86230039,"user":{"login":"ysimonson","id":127386,"avatar_url":"https://avatars.githubusercontent.com/u/127386?v=3","gravatar_id":"","url":"https://api.github.com/users/ysimonson","html_url":"https://github.com/ysimonson","followers_url":"https://api.github.com/users/ysimonson/followers","following_url":"https://api.github.com/users/ysimonson/following{/other_user}","gists_url":"https://api.github.com/users/ysimonson/gists{/gist_id}","starred_url":"https://api.github.com/users/ysimonson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ysimonson/subscriptions","organizations_url":"https://api.github.com/users/ysimonson/orgs","repos_url":"https://api.github.com/users/ysimonson/repos","events_url":"https://api.github.com/users/ysimonson/events{/privacy}","received_events_url":"https://api.github.com/users/ysimonson/received_events","type":"User","site_admin":false},"created_at":"2015-03-25T21:54:05Z","updated_at":"2015-03-25T21:54:05Z","body":"No worries at all, I didn't think it was rude.\r\n\r\nThe disconnect happened over the course of a few days and forgetting that there was both a stable v1 on gopkg and a v2 on github. After realizing the issue, I incorrectly assumed that the docs didn't provide such notice.\r\n\r\nAt this point it's nitpicking - as the docs do outline the releases clearly - but I think I wouldn't have made the mistake if there were separate godoc buttons / usage instructions (one under the \"current version\" section and one under the \"earlier versions\" section). This would have the added benefit of linking off to the online documentation for both versions of the library.\r\n\r\nI'd be happy to make a PR with the change if you think it makes sense.\r\n"}}