{"action":"opened","issue":{"url":"https://api.github.com/repos/angular-translate/angular-translate/issues/963","labels_url":"https://api.github.com/repos/angular-translate/angular-translate/issues/963/labels{/name}","comments_url":"https://api.github.com/repos/angular-translate/angular-translate/issues/963/comments","events_url":"https://api.github.com/repos/angular-translate/angular-translate/issues/963/events","html_url":"https://github.com/angular-translate/angular-translate/issues/963","id":62457446,"number":963,"title":"Bug in our software lead me to documentation error: $translate.preferredLanguage","user":{"login":"jcalfee","id":204121,"avatar_url":"https://avatars.githubusercontent.com/u/204121?v=3","gravatar_id":"","url":"https://api.github.com/users/jcalfee","html_url":"https://github.com/jcalfee","followers_url":"https://api.github.com/users/jcalfee/followers","following_url":"https://api.github.com/users/jcalfee/following{/other_user}","gists_url":"https://api.github.com/users/jcalfee/gists{/gist_id}","starred_url":"https://api.github.com/users/jcalfee/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jcalfee/subscriptions","organizations_url":"https://api.github.com/users/jcalfee/orgs","repos_url":"https://api.github.com/users/jcalfee/repos","events_url":"https://api.github.com/users/jcalfee/events{/privacy}","received_events_url":"https://api.github.com/users/jcalfee/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-03-17T16:53:05Z","updated_at":"2015-03-17T16:53:05Z","closed_at":null,"body":"It says \"Returns the language key\" but language key is a parameter.  Then is says that is returns the preferred language key.  I'm investigating a bug in our code and came across this method.  I wonder if having clear and correct docs on this method would have helped avoid the bug..  \r\n\r\nSee: http://angular-translate.github.io/docs/#/api/pascalprecht.translate.$translate\r\n```\r\npreferredLanguage(langKey)\r\n\r\nReturns the language key for the preferred language.\r\n\r\nParameters\r\nParam\tType\tDetails\r\nlangKey\tstring\t\r\nlanguage String or Array to be used as preferredLanguage (changing at runtime)\r\n\r\nReturns\r\npreferred language key\r\n```"}}