{"action":"created","issue":{"url":"https://api.github.com/repos/AtomLinter/linter-plus/issues/48","labels_url":"https://api.github.com/repos/AtomLinter/linter-plus/issues/48/labels{/name}","comments_url":"https://api.github.com/repos/AtomLinter/linter-plus/issues/48/comments","events_url":"https://api.github.com/repos/AtomLinter/linter-plus/issues/48/events","html_url":"https://github.com/AtomLinter/linter-plus/issues/48","id":86850441,"number":48,"title":"\"API questions/suggestions\"","user":{"login":"k2b6s9j","id":594124,"avatar_url":"https://avatars.githubusercontent.com/u/594124?v=3","gravatar_id":"","url":"https://api.github.com/users/k2b6s9j","html_url":"https://github.com/k2b6s9j","followers_url":"https://api.github.com/users/k2b6s9j/followers","following_url":"https://api.github.com/users/k2b6s9j/following{/other_user}","gists_url":"https://api.github.com/users/k2b6s9j/gists{/gist_id}","starred_url":"https://api.github.com/users/k2b6s9j/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/k2b6s9j/subscriptions","organizations_url":"https://api.github.com/users/k2b6s9j/orgs","repos_url":"https://api.github.com/users/k2b6s9j/repos","events_url":"https://api.github.com/users/k2b6s9j/events{/privacy}","received_events_url":"https://api.github.com/users/k2b6s9j/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":34,"created_at":"2015-06-10T05:52:50Z","updated_at":"2015-06-14T07:15:35Z","closed_at":"2015-06-14T07:15:35Z","body":"### Original Ticket Opening Text from AtomLinterPlus/linter-plus#3 by @lierdakil\r\nWhile reading wiki page on service-provider API, I found some decisions a little bit puzzling.\r\n\r\nHere's a list of what immediately popped into my mind:\r\n\r\n1. Why pass both editor and buffer to `lint`? Buffer is always available through `getBuffer()`, and in most cases editor reference is not needed at all, since plumbing should be handled by AtomLinter anyway.\r\n2. While on topic, why use positional parameters as arguments to `lint`, and not an object? Using object would be considerably more flexible with little overhead, using CoffeeScript's argument object unpacking. Of course, if you choose to use a single `editor` argument, that's not applicable.\r\n3. `scope` and `scopes` seem a little misleading names. Something more descriptive, like `grammarScopes` and `linterScope` would be a bit better.\r\n4. Same goes for Message and Trace fields: `position` is not position, but range, and `file` is not a file, but a URI (presumably), or file path (if you prefer), so `fileURI`/`filePath` might be more descriptive (btw, is it absolute or relative to project directory?). `message` and `html` could be a little more descriptive as well, but I'm not sure I understand semantics correctly, so I can't offer any options on `html`. I'd rename `message` to `text`, though, since whole object itself is semantically a \"message\".\r\n\r\nThat's from the top of my head.\r\n\r\n### Image Archive of Original Conversation\r\n![image](https://cloud.githubusercontent.com/assets/594124/8075839/73bd3b8c-0f02-11e5-9d64-866a0fad5d8e.png)\r\n\r\n### Everyone Involved in Original Conversation\r\n@lierdakil\r\n@steelbrain\r\n@k2b6s9j"},"comment":{"url":"https://api.github.com/repos/AtomLinter/linter-plus/issues/comments/111794438","html_url":"https://github.com/AtomLinter/linter-plus/issues/48#issuecomment-111794438","issue_url":"https://api.github.com/repos/AtomLinter/linter-plus/issues/48","id":111794438,"user":{"login":"steelbrain","id":4278113,"avatar_url":"https://avatars.githubusercontent.com/u/4278113?v=3","gravatar_id":"","url":"https://api.github.com/users/steelbrain","html_url":"https://github.com/steelbrain","followers_url":"https://api.github.com/users/steelbrain/followers","following_url":"https://api.github.com/users/steelbrain/following{/other_user}","gists_url":"https://api.github.com/users/steelbrain/gists{/gist_id}","starred_url":"https://api.github.com/users/steelbrain/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/steelbrain/subscriptions","organizations_url":"https://api.github.com/users/steelbrain/orgs","repos_url":"https://api.github.com/users/steelbrain/repos","events_url":"https://api.github.com/users/steelbrain/events{/privacy}","received_events_url":"https://api.github.com/users/steelbrain/received_events","type":"User","site_admin":false},"created_at":"2015-06-14T07:15:35Z","updated_at":"2015-06-14T07:15:35Z","body":"Thank you for your awesome suggestions, We really appreciate it, feel free to re-open if you have more."}}