{"action":"created","issue":{"url":"https://api.github.com/repos/astropy/astroplan/issues/75","labels_url":"https://api.github.com/repos/astropy/astroplan/issues/75/labels{/name}","comments_url":"https://api.github.com/repos/astropy/astroplan/issues/75/comments","events_url":"https://api.github.com/repos/astropy/astroplan/issues/75/events","html_url":"https://github.com/astropy/astroplan/issues/75","id":103683751,"number":75,"title":"Improve overview for Astroplan in various places","user":{"login":"cdeil","id":852409,"avatar_url":"https://avatars.githubusercontent.com/u/852409?v=3","gravatar_id":"","url":"https://api.github.com/users/cdeil","html_url":"https://github.com/cdeil","followers_url":"https://api.github.com/users/cdeil/followers","following_url":"https://api.github.com/users/cdeil/following{/other_user}","gists_url":"https://api.github.com/users/cdeil/gists{/gist_id}","starred_url":"https://api.github.com/users/cdeil/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cdeil/subscriptions","organizations_url":"https://api.github.com/users/cdeil/orgs","repos_url":"https://api.github.com/users/cdeil/repos","events_url":"https://api.github.com/users/cdeil/events{/privacy}","received_events_url":"https://api.github.com/users/cdeil/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/astropy/astroplan/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"closed","locked":false,"assignee":{"login":"bmorris3","id":3497584,"avatar_url":"https://avatars.githubusercontent.com/u/3497584?v=3","gravatar_id":"","url":"https://api.github.com/users/bmorris3","html_url":"https://github.com/bmorris3","followers_url":"https://api.github.com/users/bmorris3/followers","following_url":"https://api.github.com/users/bmorris3/following{/other_user}","gists_url":"https://api.github.com/users/bmorris3/gists{/gist_id}","starred_url":"https://api.github.com/users/bmorris3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bmorris3/subscriptions","organizations_url":"https://api.github.com/users/bmorris3/orgs","repos_url":"https://api.github.com/users/bmorris3/repos","events_url":"https://api.github.com/users/bmorris3/events{/privacy}","received_events_url":"https://api.github.com/users/bmorris3/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/astropy/astroplan/milestones/1","html_url":"https://github.com/astropy/astroplan/milestones/0.1%20release","labels_url":"https://api.github.com/repos/astropy/astroplan/milestones/1/labels","id":1087263,"number":1,"title":"0.1 release","description":"First release","creator":{"login":"cdeil","id":852409,"avatar_url":"https://avatars.githubusercontent.com/u/852409?v=3","gravatar_id":"","url":"https://api.github.com/users/cdeil","html_url":"https://github.com/cdeil","followers_url":"https://api.github.com/users/cdeil/followers","following_url":"https://api.github.com/users/cdeil/following{/other_user}","gists_url":"https://api.github.com/users/cdeil/gists{/gist_id}","starred_url":"https://api.github.com/users/cdeil/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cdeil/subscriptions","organizations_url":"https://api.github.com/users/cdeil/orgs","repos_url":"https://api.github.com/users/cdeil/repos","events_url":"https://api.github.com/users/cdeil/events{/privacy}","received_events_url":"https://api.github.com/users/cdeil/received_events","type":"User","site_admin":false},"open_issues":11,"closed_issues":43,"state":"open","created_at":"2015-04-28T11:35:13Z","updated_at":"2015-09-01T19:51:25Z","due_on":"2015-08-27T22:00:00Z","closed_at":null},"comments":1,"created_at":"2015-08-28T09:28:55Z","updated_at":"2015-09-01T19:51:25Z","closed_at":"2015-09-01T19:51:25Z","body":"@bmorris3 – Could you please try to improve the overview description for Astroplan in various places before the 0.1 release today?\r\n\r\nOne place is the \"long description\" that gets displayed on PyPI, and I think it would be good to have at least a sentence or two and a link e.g. to the docs. Just as an example, see https://pypi.python.org/pypi/gammapy/0.3\r\nThe text you see there is from https://github.com/gammapy/gammapy/blob/master/LONG_DESCRIPTION.rst  which gets pulled in like this: https://github.com/gammapy/gammapy/blob/master/setup.py#L40\r\n\r\nReally, there's four \"landing pages\" for new users where we could use the same basic info about Astroplan:\r\n* first part of `README.rst` for someone that goes to the Github repo or has the code locally\r\n* `LONG_DESCRIPTION.rst` for PyPI\r\n* first part of `docs/index.rst` for the docs\r\n* `astroplan/__init__.py` docstring for someone that does `import astroplan` and would like to know how to get started.\r\n\r\nI think in all cases one sentence and a link to the online repo and the docs is sufficient, but of course some more info is OK as well.\r\n\r\nFrom Gammapy I know that it's hard to implement this without avoiding some duplication, but I guess that's OK if ingesting the description from another file isn't possible somewhere.\r\nOne more thing ... eventually I wanted the top-level docs page to be short and added an About page for Gammapy (https://gammapy.readthedocs.org/en/latest/about.html) ... I think that could be a good idea for Astroplan as well.\r\n\r\nPS: I think \"Observation planning package for astronomers\" is a bit boring  .... \"Observing like a boss! –– Astroplan is is the observation planning Kepler and Hubble wished they had.\" ... @bmorris3 I trust you can come up with some better slogan / short description for astroplan!\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/astropy/astroplan/issues/comments/136839719","html_url":"https://github.com/astropy/astroplan/issues/75#issuecomment-136839719","issue_url":"https://api.github.com/repos/astropy/astroplan/issues/75","id":136839719,"user":{"login":"bmorris3","id":3497584,"avatar_url":"https://avatars.githubusercontent.com/u/3497584?v=3","gravatar_id":"","url":"https://api.github.com/users/bmorris3","html_url":"https://github.com/bmorris3","followers_url":"https://api.github.com/users/bmorris3/followers","following_url":"https://api.github.com/users/bmorris3/following{/other_user}","gists_url":"https://api.github.com/users/bmorris3/gists{/gist_id}","starred_url":"https://api.github.com/users/bmorris3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bmorris3/subscriptions","organizations_url":"https://api.github.com/users/bmorris3/orgs","repos_url":"https://api.github.com/users/bmorris3/repos","events_url":"https://api.github.com/users/bmorris3/events{/privacy}","received_events_url":"https://api.github.com/users/bmorris3/received_events","type":"User","site_admin":false},"created_at":"2015-09-01T19:51:25Z","updated_at":"2015-09-01T19:51:25Z","body":"Closed by merge of #79."}}