{"action":"created","issue":{"url":"https://api.github.com/repos/aspnet/Docs/issues/581","labels_url":"https://api.github.com/repos/aspnet/Docs/issues/581/labels{/name}","comments_url":"https://api.github.com/repos/aspnet/Docs/issues/581/comments","events_url":"https://api.github.com/repos/aspnet/Docs/issues/581/events","html_url":"https://github.com/aspnet/Docs/issues/581","id":113957361,"number":581,"title":"Improve coordination of documentation publication to ease on-boarding --- Was: Make CLI utilities self-documenting","user":{"login":"oheard","id":11109,"avatar_url":"https://avatars.githubusercontent.com/u/11109?v=3","gravatar_id":"","url":"https://api.github.com/users/oheard","html_url":"https://github.com/oheard","followers_url":"https://api.github.com/users/oheard/followers","following_url":"https://api.github.com/users/oheard/following{/other_user}","gists_url":"https://api.github.com/users/oheard/gists{/gist_id}","starred_url":"https://api.github.com/users/oheard/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/oheard/subscriptions","organizations_url":"https://api.github.com/users/oheard/orgs","repos_url":"https://api.github.com/users/oheard/repos","events_url":"https://api.github.com/users/oheard/events{/privacy}","received_events_url":"https://api.github.com/users/oheard/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-10-29T00:57:16Z","updated_at":"2015-10-29T01:37:16Z","closed_at":null,"body":"I apologise if this isn't the appropriate place to submit this but I'm running into a lot of frustration just doing simple tasks with the dnu and dnvm CLI tools due to a lack of accessible documentation.\r\n\r\nDocumentation is out there, but it appears to surface out of the ether and then disappear never to be found again. A lot of pages simply say that the docs haven't been written yet, where Visual Studio does provide documentation upon project creation once that tab has been closed it's lost forever so this seems to partly be a coordination/communication problem (why isn't that documentation on docs.asp.net?)\r\n\r\nBoth Google and Bing have proved useless in trying to find out how to do simple tasks such as install nuget packages or install/remove versions of .Net. Results either point to empty documentation pages or lead down a labyrinth of vaguely related but ultimately unhelpful documents.\r\n\r\nI think the most appropriate thing to do is to make dnvm and dnu self-documenting much like similar tools from other platforms (gem, pip, npm, etc). I personally have had countless start/stops over the last few months due to frustration in this area."},"comment":{"url":"https://api.github.com/repos/aspnet/Docs/issues/comments/152048253","html_url":"https://github.com/aspnet/Docs/issues/581#issuecomment-152048253","issue_url":"https://api.github.com/repos/aspnet/Docs/issues/581","id":152048253,"user":{"login":"oheard","id":11109,"avatar_url":"https://avatars.githubusercontent.com/u/11109?v=3","gravatar_id":"","url":"https://api.github.com/users/oheard","html_url":"https://github.com/oheard","followers_url":"https://api.github.com/users/oheard/followers","following_url":"https://api.github.com/users/oheard/following{/other_user}","gists_url":"https://api.github.com/users/oheard/gists{/gist_id}","starred_url":"https://api.github.com/users/oheard/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/oheard/subscriptions","organizations_url":"https://api.github.com/users/oheard/orgs","repos_url":"https://api.github.com/users/oheard/repos","events_url":"https://api.github.com/users/oheard/events{/privacy}","received_events_url":"https://api.github.com/users/oheard/received_events","type":"User","site_admin":false},"created_at":"2015-10-29T01:37:16Z","updated_at":"2015-10-29T01:37:16Z","body":"Mostly on the subcommands and options accepted by the dnvm and dnu commands in this particular instance. Now that I have the tools installed and working correctly they /are/ self-documenting, which is fantastic.\r\n\r\nThe larger problem is the documentation that's out there is incomplete (which means following link after link to empty pages, frustration growing with every click (if it's not written, don't give us false hope!)) or is some long-winded \"tutorial\"-style document written by a third-party. The latter type drowns out useful information in search results and appear to be an attempt at compensating for the absence of official documentation.\r\n\r\nOne such example when searching for \"dnu options\", the top result in Google (for me, at least), is this: http://typecastexception.com/post/2015/05/17/DNVM-DNX-and-DNU-Understanding-the-ASPNET-5-Runtime-Options.aspx\r\n\r\nWhen really what I'm looking for is this: ...nevermind I've lost it again, there is a GitHub page on here somewhere with two header links, one for dnvm usage and one for dnu usage. But I literally can't find it anymore (perhaps I should employ CTRL-D next time).\r\n\r\nBut I think you can see that for someone used to consuming information-dense text the typecastexception.com article is not appropriate. It reminds me of those tortuous IT classes some people are forced to endure, along the lines of \"1) Click Start; 2) Click Word; 3) Click File; 4) Click Open...\". It's just a drag, really.\r\n\r\nI hope by bringing this up we can do something about it, I don't want to come across as a whiner (which I'm starting to feel I may be)."}}