{"action":"created","issue":{"url":"https://api.github.com/repos/meteor/meteor/issues/3474","labels_url":"https://api.github.com/repos/meteor/meteor/issues/3474/labels{/name}","comments_url":"https://api.github.com/repos/meteor/meteor/issues/3474/comments","events_url":"https://api.github.com/repos/meteor/meteor/issues/3474/events","html_url":"https://github.com/meteor/meteor/issues/3474","id":54307973,"number":3474,"title":"Get full command-line docs on the web","user":{"login":"matteodem","id":1301147,"avatar_url":"https://avatars.githubusercontent.com/u/1301147?v=3","gravatar_id":"","url":"https://api.github.com/users/matteodem","html_url":"https://github.com/matteodem","followers_url":"https://api.github.com/users/matteodem/followers","following_url":"https://api.github.com/users/matteodem/following{/other_user}","gists_url":"https://api.github.com/users/matteodem/gists{/gist_id}","starred_url":"https://api.github.com/users/matteodem/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matteodem/subscriptions","organizations_url":"https://api.github.com/users/matteodem/orgs","repos_url":"https://api.github.com/users/matteodem/repos","events_url":"https://api.github.com/users/matteodem/events{/privacy}","received_events_url":"https://api.github.com/users/matteodem/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/meteor/meteor/labels/Project:Docs","name":"Project:Docs","color":"fbca04"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":7,"created_at":"2015-01-14T10:46:37Z","updated_at":"2015-01-27T01:07:56Z","closed_at":null,"body":"Having a more detailed documentation for commands like \"set-unmigrated\" on http://docs.meteor.com/#/full/ and others would be helpful. Also I don't see \"set-unmigrated\" in the list when executing ```meteor admin help```.\r\n"},"comment":{"url":"https://api.github.com/repos/meteor/meteor/issues/comments/71572110","html_url":"https://github.com/meteor/meteor/issues/3474#issuecomment-71572110","issue_url":"https://api.github.com/repos/meteor/meteor/issues/3474","id":71572110,"user":{"login":"dandv","id":33569,"avatar_url":"https://avatars.githubusercontent.com/u/33569?v=3","gravatar_id":"","url":"https://api.github.com/users/dandv","html_url":"https://github.com/dandv","followers_url":"https://api.github.com/users/dandv/followers","following_url":"https://api.github.com/users/dandv/following{/other_user}","gists_url":"https://api.github.com/users/dandv/gists{/gist_id}","starred_url":"https://api.github.com/users/dandv/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dandv/subscriptions","organizations_url":"https://api.github.com/users/dandv/orgs","repos_url":"https://api.github.com/users/dandv/repos","events_url":"https://api.github.com/users/dandv/events{/privacy}","received_events_url":"https://api.github.com/users/dandv/received_events","type":"User","site_admin":false},"created_at":"2015-01-27T01:07:56Z","updated_at":"2015-01-27T01:07:56Z","body":"I was about to send a doc patch adding \"--update\" to `meteor publish`, when I saw this issue. I understand why the help shouldn't be duplicated on docs.meteor.com/full.\r\n\r\nOn the other hand, most developers, especially those who *have* used Meteor before, will search through the docs (thanks in part to @stubailo's excellent search feature), or will land to a specific command from the ToC or via an anchor link found online, e.g. http://docs.meteor.com/#/full/meteorpublish\r\n\r\nIn all these frequent cases, they'll miss the new overview paragraph, and may reasonably conclude that the options presented under each command represent the full set of options. Also, when searching for something like \"unmigrated\" returns nothing, the developing experience is suboptimal.\r\n\r\nWhat would be some ways to address this?\r\n\r\n* Include a bit of text at the end of each CLI command along the lines of \"This is only an overview; please consult `meteor help` for more information\"?\r\n* Transclude the full help in both docs.meteor.com and `meteor help`, and maybe hide it on docs under a \"Show more\" link?"}}