{"action":"created","issue":{"url":"https://api.github.com/repos/aspnet/Home/issues/289","repository_url":"https://api.github.com/repos/aspnet/Home","labels_url":"https://api.github.com/repos/aspnet/Home/issues/289/labels{/name}","comments_url":"https://api.github.com/repos/aspnet/Home/issues/289/comments","events_url":"https://api.github.com/repos/aspnet/Home/issues/289/events","html_url":"https://github.com/aspnet/Home/issues/289","id":55345396,"number":289,"title":"What format should we use for the ASP.NET 5 documentation?","user":{"login":"danroth27","id":1874516,"avatar_url":"https://avatars.githubusercontent.com/u/1874516?v=3","gravatar_id":"","url":"https://api.github.com/users/danroth27","html_url":"https://github.com/danroth27","followers_url":"https://api.github.com/users/danroth27/followers","following_url":"https://api.github.com/users/danroth27/following{/other_user}","gists_url":"https://api.github.com/users/danroth27/gists{/gist_id}","starred_url":"https://api.github.com/users/danroth27/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/danroth27/subscriptions","organizations_url":"https://api.github.com/users/danroth27/orgs","repos_url":"https://api.github.com/users/danroth27/repos","events_url":"https://api.github.com/users/danroth27/events{/privacy}","received_events_url":"https://api.github.com/users/danroth27/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/aspnet/Home/labels/discussion","name":"discussion","color":"009800"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":71,"created_at":"2015-01-23T23:13:40Z","updated_at":"2016-03-07T11:57:18Z","closed_at":"2015-03-09T05:27:46Z","body":"We'd like to have our docs for ASP.NET 5 be open-source on GitHub and easy to contribute to. We need to pick a documentation format and build system that is open-source friendly and easy to use, but can also scale to our documentation needs.\r\n\r\nWhat documentation format would folks like to see us use? Markdown is nice and simple, but lacks many features of more mature documentation systems. Should we use [ReStructured Text](http://docutils.sourceforge.net/rst.html)? Something else?\r\n\r\nFor a doc build system and hosting We are looking at [readthedocs.org](http://readthedocx.org) and [Sphinx](http://sphinx-doc.org/). For reference docs we are looking at [nudoq.org](http://nudoq.org). Are there other doc systems we should consider?\r\n\r\nThanks!"},"comment":{"url":"https://api.github.com/repos/aspnet/Home/issues/comments/193220410","html_url":"https://github.com/aspnet/Home/issues/289#issuecomment-193220410","issue_url":"https://api.github.com/repos/aspnet/Home/issues/289","id":193220410,"user":{"login":"simonmurdock","id":5403478,"avatar_url":"https://avatars.githubusercontent.com/u/5403478?v=3","gravatar_id":"","url":"https://api.github.com/users/simonmurdock","html_url":"https://github.com/simonmurdock","followers_url":"https://api.github.com/users/simonmurdock/followers","following_url":"https://api.github.com/users/simonmurdock/following{/other_user}","gists_url":"https://api.github.com/users/simonmurdock/gists{/gist_id}","starred_url":"https://api.github.com/users/simonmurdock/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/simonmurdock/subscriptions","organizations_url":"https://api.github.com/users/simonmurdock/orgs","repos_url":"https://api.github.com/users/simonmurdock/repos","events_url":"https://api.github.com/users/simonmurdock/events{/privacy}","received_events_url":"https://api.github.com/users/simonmurdock/received_events","type":"User","site_admin":false},"created_at":"2016-03-07T11:57:18Z","updated_at":"2016-03-07T11:57:18Z","body":"Yeah @cocowalla  I'm in eternal flux about the state of the union with documentation. I'm now writing my articles in sphinx, but no real nice way to generate sphinx-integrated API docs.\r\n\r\nThe current plan is Sphinx for all the articles and a separate site for DocFX's output, until the Sphinx ApiDocs look a little nicer."}}