{"action":"created","issue":{"url":"https://api.github.com/repos/civisanalytics/civis-python/issues/235","repository_url":"https://api.github.com/repos/civisanalytics/civis-python","labels_url":"https://api.github.com/repos/civisanalytics/civis-python/issues/235/labels{/name}","comments_url":"https://api.github.com/repos/civisanalytics/civis-python/issues/235/comments","events_url":"https://api.github.com/repos/civisanalytics/civis-python/issues/235/events","html_url":"https://github.com/civisanalytics/civis-python/issues/235","id":299165487,"number":235,"title":"Surface the documentation for civis.find and civis.find_one","user":{"login":"jacksonllee","id":6993153,"avatar_url":"https://avatars1.githubusercontent.com/u/6993153?v=4","gravatar_id":"","url":"https://api.github.com/users/jacksonllee","html_url":"https://github.com/jacksonllee","followers_url":"https://api.github.com/users/jacksonllee/followers","following_url":"https://api.github.com/users/jacksonllee/following{/other_user}","gists_url":"https://api.github.com/users/jacksonllee/gists{/gist_id}","starred_url":"https://api.github.com/users/jacksonllee/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jacksonllee/subscriptions","organizations_url":"https://api.github.com/users/jacksonllee/orgs","repos_url":"https://api.github.com/users/jacksonllee/repos","events_url":"https://api.github.com/users/jacksonllee/events{/privacy}","received_events_url":"https://api.github.com/users/jacksonllee/received_events","type":"User","site_admin":false},"labels":[{"id":599021606,"url":"https://api.github.com/repos/civisanalytics/civis-python/labels/Documentation","name":"Documentation","color":"fbca04","default":false},{"id":472394894,"url":"https://api.github.com/repos/civisanalytics/civis-python/labels/question","name":"question","color":"cc317c","default":true}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":2,"created_at":"2018-02-21T23:15:56Z","updated_at":"2018-02-21T23:42:10Z","closed_at":null,"author_association":"MEMBER","body":"The docstrings for `civis.find` and `civis.find_one` have been recently added at #224, but the two functions aren't explicitly mentioned anywhere in the current Sphinx documentation. Currently there isn't a page dedicated to utility functions of this sort. Given that their major use case is to filter `civis.response.Response` objects, how about adding a section like \"Utility Functions\" or something in [`responses.rst`](https://github.com/civisanalytics/civis-python/blob/master/docs/source/responses.rst)?\r\n\r\n@stephen-hoover @keithing "},"comment":{"url":"https://api.github.com/repos/civisanalytics/civis-python/issues/comments/367516669","html_url":"https://github.com/civisanalytics/civis-python/issues/235#issuecomment-367516669","issue_url":"https://api.github.com/repos/civisanalytics/civis-python/issues/235","id":367516669,"user":{"login":"stephen-hoover","id":8355977,"avatar_url":"https://avatars1.githubusercontent.com/u/8355977?v=4","gravatar_id":"","url":"https://api.github.com/users/stephen-hoover","html_url":"https://github.com/stephen-hoover","followers_url":"https://api.github.com/users/stephen-hoover/followers","following_url":"https://api.github.com/users/stephen-hoover/following{/other_user}","gists_url":"https://api.github.com/users/stephen-hoover/gists{/gist_id}","starred_url":"https://api.github.com/users/stephen-hoover/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stephen-hoover/subscriptions","organizations_url":"https://api.github.com/users/stephen-hoover/orgs","repos_url":"https://api.github.com/users/stephen-hoover/repos","events_url":"https://api.github.com/users/stephen-hoover/events{/privacy}","received_events_url":"https://api.github.com/users/stephen-hoover/received_events","type":"User","site_admin":false},"created_at":"2018-02-21T23:42:10Z","updated_at":"2018-02-21T23:42:10Z","author_association":"MEMBER","body":"You're right! My apologies. I do still think that these functions could make more sense in the `user_guide.rst` file, but they might also work in `responses.rst` if that section gets some explanatory text.."}}
{"actor":{"display_login":"stephen-hoover"}}