{"action":"created","issue":{"url":"https://api.github.com/repos/npm/npm/issues/10069","labels_url":"https://api.github.com/repos/npm/npm/issues/10069/labels{/name}","comments_url":"https://api.github.com/repos/npm/npm/issues/10069/comments","events_url":"https://api.github.com/repos/npm/npm/issues/10069/events","html_url":"https://github.com/npm/npm/issues/10069","id":112700398,"number":10069,"title":"many npm options are not listed anywhere in documentation","user":{"login":"spikegrobstein","id":45886,"avatar_url":"https://avatars.githubusercontent.com/u/45886?v=3","gravatar_id":"","url":"https://api.github.com/users/spikegrobstein","html_url":"https://github.com/spikegrobstein","followers_url":"https://api.github.com/users/spikegrobstein/followers","following_url":"https://api.github.com/users/spikegrobstein/following{/other_user}","gists_url":"https://api.github.com/users/spikegrobstein/gists{/gist_id}","starred_url":"https://api.github.com/users/spikegrobstein/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/spikegrobstein/subscriptions","organizations_url":"https://api.github.com/users/spikegrobstein/orgs","repos_url":"https://api.github.com/users/spikegrobstein/repos","events_url":"https://api.github.com/users/spikegrobstein/events{/privacy}","received_events_url":"https://api.github.com/users/spikegrobstein/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-10-21T23:38:34Z","updated_at":"2015-10-21T23:56:27Z","closed_at":null,"body":"Many times, in the documentation for the NPM actions, an exhaustive list of available options are not shown. I've had trouble finding documentation on options that I *know* exist as well as have had trouble finding out whether options that *should* exist are real or actually do what I expect.\r\n\r\nThe best example is the `install` page (https://docs.npmjs.com/cli/install) doesn't list the `--deployment` flag anywhere, and only passively mentions `--production` down the page, hidden in a paragraph.\r\n\r\nIt would be really great if there was a table of the available options and what they do in one place."},"comment":{"url":"https://api.github.com/repos/npm/npm/issues/comments/150057070","html_url":"https://github.com/npm/npm/issues/10069#issuecomment-150057070","issue_url":"https://api.github.com/repos/npm/npm/issues/10069","id":150057070,"user":{"login":"spikegrobstein","id":45886,"avatar_url":"https://avatars.githubusercontent.com/u/45886?v=3","gravatar_id":"","url":"https://api.github.com/users/spikegrobstein","html_url":"https://github.com/spikegrobstein","followers_url":"https://api.github.com/users/spikegrobstein/followers","following_url":"https://api.github.com/users/spikegrobstein/following{/other_user}","gists_url":"https://api.github.com/users/spikegrobstein/gists{/gist_id}","starred_url":"https://api.github.com/users/spikegrobstein/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/spikegrobstein/subscriptions","organizations_url":"https://api.github.com/users/spikegrobstein/orgs","repos_url":"https://api.github.com/users/spikegrobstein/repos","events_url":"https://api.github.com/users/spikegrobstein/events{/privacy}","received_events_url":"https://api.github.com/users/spikegrobstein/received_events","type":"User","site_admin":false},"created_at":"2015-10-21T23:56:27Z","updated_at":"2015-10-21T23:56:27Z","body":"It was used all over the place in build scripts at my last job and the guy who set it up told me that it was an undocumented feature. At the time --production and --save, etc were not documented either, so I believed him. Maybe it's not a thing and he totally lied to me?\r\n\r\nanyway, I\"m moving this stuff over to the docs repo, if you want to continue the convo there."}}