{"action":"created","issue":{"url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/86","labels_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/86/labels{/name}","comments_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/86/comments","events_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/86/events","html_url":"https://github.com/matrix-org/matrix-doc/pull/86","id":110200694,"number":86,"title":"Add draft search API docs","user":{"login":"erikjohnston","id":8428120,"avatar_url":"https://avatars.githubusercontent.com/u/8428120?v=3","gravatar_id":"","url":"https://api.github.com/users/erikjohnston","html_url":"https://github.com/erikjohnston","followers_url":"https://api.github.com/users/erikjohnston/followers","following_url":"https://api.github.com/users/erikjohnston/following{/other_user}","gists_url":"https://api.github.com/users/erikjohnston/gists{/gist_id}","starred_url":"https://api.github.com/users/erikjohnston/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/erikjohnston/subscriptions","organizations_url":"https://api.github.com/users/erikjohnston/orgs","repos_url":"https://api.github.com/users/erikjohnston/repos","events_url":"https://api.github.com/users/erikjohnston/events{/privacy}","received_events_url":"https://api.github.com/users/erikjohnston/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-10-07T11:01:04Z","updated_at":"2015-10-07T11:41:03Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/matrix-org/matrix-doc/pulls/86","html_url":"https://github.com/matrix-org/matrix-doc/pull/86","diff_url":"https://github.com/matrix-org/matrix-doc/pull/86.diff","patch_url":"https://github.com/matrix-org/matrix-doc/pull/86.patch"},"body":"This is a straw man for the search API. Hopefully it should include most of the use cases and features that people/servers may want to support.\r\n\r\n*Note*: A lot of the API is optional, and the likelihood is that Synapse will only implement a subset of the features. The reason for including features in this design document is so that we have an idea of how those features would fit into the search API in the future.\r\n\r\n*Note*: There are a bunch of open questions at the bottom.\r\n\r\n[Rendered](https://github.com/matrix-org/matrix-doc/blob/erikj/search/drafts/search_api.md)\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/comments/146164582","html_url":"https://github.com/matrix-org/matrix-doc/pull/86#issuecomment-146164582","issue_url":"https://api.github.com/repos/matrix-org/matrix-doc/issues/86","id":146164582,"user":{"login":"ara4n","id":1294269,"avatar_url":"https://avatars.githubusercontent.com/u/1294269?v=3","gravatar_id":"","url":"https://api.github.com/users/ara4n","html_url":"https://github.com/ara4n","followers_url":"https://api.github.com/users/ara4n/followers","following_url":"https://api.github.com/users/ara4n/following{/other_user}","gists_url":"https://api.github.com/users/ara4n/gists{/gist_id}","starred_url":"https://api.github.com/users/ara4n/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ara4n/subscriptions","organizations_url":"https://api.github.com/users/ara4n/orgs","repos_url":"https://api.github.com/users/ara4n/repos","events_url":"https://api.github.com/users/ara4n/events{/privacy}","received_events_url":"https://api.github.com/users/ara4n/received_events","type":"User","site_admin":false},"created_at":"2015-10-07T11:41:03Z","updated_at":"2015-10-07T11:41:03Z","body":"Can you give some use cases for facets, and spell out how pagination interacts with groups/facets?\n\nI like the idea of a slightly more structured search API than google's ?q=term, but worried this is getting too complicated and faffy for clients to implement - both for constructing the query and navigating the response.\n\n(also, why markdown? :/)\n\n> On 7 Oct 2015, at 06:01, Erik Johnston <notifications@github.com> wrote:\n> \n> This is a straw man for the search API. Hopefully it should include most of the use cases and features that people/servers may want to support.\n> \n> Note: A lot of the API is optional, and the likelihood is that Synapse will only implement a subset of the features. The reason for including features in this design document is so that we have an idea of how those features would fit into the search API in the future.\n> \n> Rendered\n> \n> You can view, comment on, or merge this pull request online at:\n> \n>   https://github.com/matrix-org/matrix-doc/pull/86\n> \n> Commit Summary\n> \n> Add draft search API docs\n> Fixup JSON format\n> File Changes\n> \n> A drafts/search_api.md (198)\n> Patch Links:\n> \n> https://github.com/matrix-org/matrix-doc/pull/86.patch\n> https://github.com/matrix-org/matrix-doc/pull/86.diff\n> —\n> Reply to this email directly or view it on GitHub.\n> \n"}}