{"action":"created","issue":{"url":"https://api.github.com/repos/mkdocs/mkdocs/issues/193","labels_url":"https://api.github.com/repos/mkdocs/mkdocs/issues/193/labels{/name}","comments_url":"https://api.github.com/repos/mkdocs/mkdocs/issues/193/comments","events_url":"https://api.github.com/repos/mkdocs/mkdocs/issues/193/events","html_url":"https://github.com/mkdocs/mkdocs/issues/193","id":47977186,"number":193,"title":"Support multiple versions of docs.","user":{"login":"jimporter","id":826865,"avatar_url":"https://avatars.githubusercontent.com/u/826865?v=3","gravatar_id":"","url":"https://api.github.com/users/jimporter","html_url":"https://github.com/jimporter","followers_url":"https://api.github.com/users/jimporter/followers","following_url":"https://api.github.com/users/jimporter/following{/other_user}","gists_url":"https://api.github.com/users/jimporter/gists{/gist_id}","starred_url":"https://api.github.com/users/jimporter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jimporter/subscriptions","organizations_url":"https://api.github.com/users/jimporter/orgs","repos_url":"https://api.github.com/users/jimporter/repos","events_url":"https://api.github.com/users/jimporter/events{/privacy}","received_events_url":"https://api.github.com/users/jimporter/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/mkdocs/mkdocs/labels/Enhancement","name":"Enhancement","color":"009800"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/mkdocs/mkdocs/milestones/4","html_url":"https://github.com/mkdocs/mkdocs/milestones/1.0.0","labels_url":"https://api.github.com/repos/mkdocs/mkdocs/milestones/4/labels","id":831184,"number":4,"title":"1.0.0","description":"The milestone is for features, changes and additions we need to land before a 1.0 release makes sense.","creator":{"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},"open_issues":12,"closed_issues":0,"state":"open","created_at":"2014-10-18T15:40:53Z","updated_at":"2015-06-15T18:11:00Z","due_on":null,"closed_at":null},"comments":21,"created_at":"2014-11-06T15:50:43Z","updated_at":"2015-06-24T16:22:54Z","closed_at":null,"body":"I'd like to be able to host different docs for different versions of my code. I know there are services like ReadTheDocs that handle this for you, but it would be nice to be able to deploy all the versions to GitHub instead. This would make the gh-deploy script a bit more complex (and there'd need to be some way of switching versions when browsing), but I think it would be generally useful.\r\n\r\nMaybe there's an argument to be made that GitHub Pages are for hosting the in-development version of your docs, and places like ReadTheDocs are for released versions; I'm not sure. My instinct is that all the versions of the docs should be hosted in the same place, though.\r\n\r\nAny thoughts about this?"},"comment":{"url":"https://api.github.com/repos/mkdocs/mkdocs/issues/comments/114930893","html_url":"https://github.com/mkdocs/mkdocs/issues/193#issuecomment-114930893","issue_url":"https://api.github.com/repos/mkdocs/mkdocs/issues/193","id":114930893,"user":{"login":"robodude666","id":172501,"avatar_url":"https://avatars.githubusercontent.com/u/172501?v=3","gravatar_id":"","url":"https://api.github.com/users/robodude666","html_url":"https://github.com/robodude666","followers_url":"https://api.github.com/users/robodude666/followers","following_url":"https://api.github.com/users/robodude666/following{/other_user}","gists_url":"https://api.github.com/users/robodude666/gists{/gist_id}","starred_url":"https://api.github.com/users/robodude666/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/robodude666/subscriptions","organizations_url":"https://api.github.com/users/robodude666/orgs","repos_url":"https://api.github.com/users/robodude666/repos","events_url":"https://api.github.com/users/robodude666/events{/privacy}","received_events_url":"https://api.github.com/users/robodude666/received_events","type":"User","site_admin":false},"created_at":"2015-06-24T16:22:54Z","updated_at":"2015-06-24T16:22:54Z","body":"@waylan I see; wasn't aware of PyPi's requirements.\r\n\r\nRegarding supporting non-mkdocs and pre-1.0 mkdocs versions, I don't think any of that should be handled by such a versioning plugin because you run the risk of adding too much bloat in order to support every possible scenario. Instead, something like this should be left to the project's developers to solve and could easily be handled via tox (or manually through virtualenv), allowing you to setup different environments and manually including commands to build from specific tags."}}