{"action":"created","issue":{"url":"https://api.github.com/repos/PyAbel/PyAbel/issues/107","repository_url":"https://api.github.com/repos/PyAbel/PyAbel","labels_url":"https://api.github.com/repos/PyAbel/PyAbel/issues/107/labels{/name}","comments_url":"https://api.github.com/repos/PyAbel/PyAbel/issues/107/comments","events_url":"https://api.github.com/repos/PyAbel/PyAbel/issues/107/events","html_url":"https://github.com/PyAbel/PyAbel/issues/107","id":136229469,"number":107,"title":"Consolidate documentation","user":{"login":"DanHickstein","id":1107796,"avatar_url":"https://avatars.githubusercontent.com/u/1107796?v=3","gravatar_id":"","url":"https://api.github.com/users/DanHickstein","html_url":"https://github.com/DanHickstein","followers_url":"https://api.github.com/users/DanHickstein/followers","following_url":"https://api.github.com/users/DanHickstein/following{/other_user}","gists_url":"https://api.github.com/users/DanHickstein/gists{/gist_id}","starred_url":"https://api.github.com/users/DanHickstein/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DanHickstein/subscriptions","organizations_url":"https://api.github.com/users/DanHickstein/orgs","repos_url":"https://api.github.com/users/DanHickstein/repos","events_url":"https://api.github.com/users/DanHickstein/events{/privacy}","received_events_url":"https://api.github.com/users/DanHickstein/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/PyAbel/PyAbel/labels/doc","name":"doc","color":"bfe5bf"}],"state":"open","locked":false,"assignee":{"login":"DanHickstein","id":1107796,"avatar_url":"https://avatars.githubusercontent.com/u/1107796?v=3","gravatar_id":"","url":"https://api.github.com/users/DanHickstein","html_url":"https://github.com/DanHickstein","followers_url":"https://api.github.com/users/DanHickstein/followers","following_url":"https://api.github.com/users/DanHickstein/following{/other_user}","gists_url":"https://api.github.com/users/DanHickstein/gists{/gist_id}","starred_url":"https://api.github.com/users/DanHickstein/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DanHickstein/subscriptions","organizations_url":"https://api.github.com/users/DanHickstein/orgs","repos_url":"https://api.github.com/users/DanHickstein/repos","events_url":"https://api.github.com/users/DanHickstein/events{/privacy}","received_events_url":"https://api.github.com/users/DanHickstein/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/PyAbel/PyAbel/milestones/2","html_url":"https://github.com/PyAbel/PyAbel/milestones/Version%200.7","labels_url":"https://api.github.com/repos/PyAbel/PyAbel/milestones/2/labels","id":1423032,"number":2,"title":"Version 0.7","description":"Adding a few other inverse Abel implementations. Converge to a consistent user interface.","creator":{"login":"rth","id":630936,"avatar_url":"https://avatars.githubusercontent.com/u/630936?v=3","gravatar_id":"","url":"https://api.github.com/users/rth","html_url":"https://github.com/rth","followers_url":"https://api.github.com/users/rth/followers","following_url":"https://api.github.com/users/rth/following{/other_user}","gists_url":"https://api.github.com/users/rth/gists{/gist_id}","starred_url":"https://api.github.com/users/rth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rth/subscriptions","organizations_url":"https://api.github.com/users/rth/orgs","repos_url":"https://api.github.com/users/rth/repos","events_url":"https://api.github.com/users/rth/events{/privacy}","received_events_url":"https://api.github.com/users/rth/received_events","type":"User","site_admin":false},"open_issues":7,"closed_issues":47,"state":"open","created_at":"2015-11-21T11:17:04Z","updated_at":"2016-02-25T00:05:31Z","due_on":null,"closed_at":null},"comments":6,"created_at":"2016-02-24T23:58:56Z","updated_at":"2016-02-25T16:53:51Z","closed_at":null,"body":"@PyAbel/developers:\r\n\r\nThere is a potential for overlapping documentation about the general properties of PyAbel. The information is potentially contained in 3 places:\r\n1. The readme file displayed at https://github.com/PyAbel/PyAbel\r\n2. The home page of the wiki: https://github.com/PyAbel/PyAbel/wiki\r\n3. There should be some general information on the main readthedocs.org page: https://pyabel.readthedocs.org/en/latest/index.html\r\n\r\nI have a proposal: basically we just use the README as the main central source of information. It's already the main thing people see on the GitHub page and we can make it appear on the readthedocs page. Also, it has a whole git history so that we can track the changes that are being made to it better than we can with the wiki. \r\n\r\nSo, we need to do a few things:\r\n\r\n1. Change the readme from .md to .rst to allow compatibility with Sphinx. I did this and it seems to work fine. You can see it here: https://github.com/DanHickstein/PyAbel/tree/doc_improvements  (I also updated it quite a bit, so let me know if there are changed you would like to see.)\r\n\r\n2. Link the readme to the Sphinx docs. I think that this works reasonably well: http://pyabel-dh-fork.readthedocs.org/en/latest/readme_link.html\r\n\r\n3. I don't know quite what to do for the wiki. I think the best it to just have the \"Home\" page on the wiki link back to the README.rst. The other pages of the wiki are still pretty useful as an easy place to host out notes about the transform methods. Alternatively we could just get rid of the wiki and move towards hosting the technical information about the transform methods in the actual documentation that will appear on readthedocs. \r\n\r\nThoughts?\r\n\r\nI can make a PR for this soon, but wanted to get your thoughts first."},"comment":{"url":"https://api.github.com/repos/PyAbel/PyAbel/issues/comments/188875624","html_url":"https://github.com/PyAbel/PyAbel/issues/107#issuecomment-188875624","issue_url":"https://api.github.com/repos/PyAbel/PyAbel/issues/107","id":188875624,"user":{"login":"ldes89150","id":3795568,"avatar_url":"https://avatars.githubusercontent.com/u/3795568?v=3","gravatar_id":"","url":"https://api.github.com/users/ldes89150","html_url":"https://github.com/ldes89150","followers_url":"https://api.github.com/users/ldes89150/followers","following_url":"https://api.github.com/users/ldes89150/following{/other_user}","gists_url":"https://api.github.com/users/ldes89150/gists{/gist_id}","starred_url":"https://api.github.com/users/ldes89150/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ldes89150/subscriptions","organizations_url":"https://api.github.com/users/ldes89150/orgs","repos_url":"https://api.github.com/users/ldes89150/repos","events_url":"https://api.github.com/users/ldes89150/events{/privacy}","received_events_url":"https://api.github.com/users/ldes89150/received_events","type":"User","site_admin":false},"created_at":"2016-02-25T16:53:51Z","updated_at":"2016-02-25T16:53:51Z","body":"I think @PyAbel/developers doesn't work on me. However, I subscribe this project, so every issues come into my mail box.\r\n\r\nPerhaps, I can add some examples related to cold atoms. :)"}}