{"action":"created","issue":{"url":"https://api.github.com/repos/rtfd/readthedocs-build/issues/3","labels_url":"https://api.github.com/repos/rtfd/readthedocs-build/issues/3/labels{/name}","comments_url":"https://api.github.com/repos/rtfd/readthedocs-build/issues/3/comments","events_url":"https://api.github.com/repos/rtfd/readthedocs-build/issues/3/events","html_url":"https://github.com/rtfd/readthedocs-build/issues/3","id":89314918,"number":3,"title":"Idea: `rtd` cli script instead of standalone `rtd-build`","user":{"login":"gregmuellegger","id":88278,"avatar_url":"https://avatars.githubusercontent.com/u/88278?v=3","gravatar_id":"","url":"https://api.github.com/users/gregmuellegger","html_url":"https://github.com/gregmuellegger","followers_url":"https://api.github.com/users/gregmuellegger/followers","following_url":"https://api.github.com/users/gregmuellegger/following{/other_user}","gists_url":"https://api.github.com/users/gregmuellegger/gists{/gist_id}","starred_url":"https://api.github.com/users/gregmuellegger/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gregmuellegger/subscriptions","organizations_url":"https://api.github.com/users/gregmuellegger/orgs","repos_url":"https://api.github.com/users/gregmuellegger/repos","events_url":"https://api.github.com/users/gregmuellegger/events{/privacy}","received_events_url":"https://api.github.com/users/gregmuellegger/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-06-18T14:54:24Z","updated_at":"2015-06-19T11:17:39Z","closed_at":null,"body":"The name `rtd-build` is very explicit about what it does, that's cool. But it doesn't allow more flexible use cases later on. For example: it should be really easy to get started with a sample `readthedocs.yml` file. That could be done by a command like `rtd init`.\r\n\r\n`rtd build` is then a subcommand that does what `rtd-build` is currently doing. That naming scheme allows for further extension, like:\r\n\r\n* `rtd test`: test for syntax and configuration issues in the yml file. It could also check your `conf.py` for problems etc.\r\n* `rtd lint`: test your documentation against heuristics about common mistakes in writing docs (similiar to what `annotatedocs` had as goal) etc.\r\n* `rtd upload`: build your docs with crazy dependencies and then upload it\r\n* `rtd register`: take the repo url from git's origin remote and try to register this project on readthedocs.org\r\n\r\nI know that this is nothing that will happen in the very near future because making the build work first is the most precious thing, but I wanted to record and discuss those thoughts here.\r\n"},"comment":{"url":"https://api.github.com/repos/rtfd/readthedocs-build/issues/comments/113480071","html_url":"https://github.com/rtfd/readthedocs-build/issues/3#issuecomment-113480071","issue_url":"https://api.github.com/repos/rtfd/readthedocs-build/issues/3","id":113480071,"user":{"login":"d0ugal","id":48211,"avatar_url":"https://avatars.githubusercontent.com/u/48211?v=3","gravatar_id":"","url":"https://api.github.com/users/d0ugal","html_url":"https://github.com/d0ugal","followers_url":"https://api.github.com/users/d0ugal/followers","following_url":"https://api.github.com/users/d0ugal/following{/other_user}","gists_url":"https://api.github.com/users/d0ugal/gists{/gist_id}","starred_url":"https://api.github.com/users/d0ugal/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/d0ugal/subscriptions","organizations_url":"https://api.github.com/users/d0ugal/orgs","repos_url":"https://api.github.com/users/d0ugal/repos","events_url":"https://api.github.com/users/d0ugal/events{/privacy}","received_events_url":"https://api.github.com/users/d0ugal/received_events","type":"User","site_admin":false},"created_at":"2015-06-19T11:17:39Z","updated_at":"2015-06-19T11:17:39Z","body":"+1 to the idea and to using click."}}