{"action":"created","issue":{"url":"https://api.github.com/repos/npm/npm/issues/10695","labels_url":"https://api.github.com/repos/npm/npm/issues/10695/labels{/name}","comments_url":"https://api.github.com/repos/npm/npm/issues/10695/comments","events_url":"https://api.github.com/repos/npm/npm/issues/10695/events","html_url":"https://github.com/npm/npm/pull/10695","id":120445104,"number":10695,"title":"doc: explain what `npm outdated`' tells you","user":{"login":"othiym23","id":418097,"avatar_url":"https://avatars.githubusercontent.com/u/418097?v=3","gravatar_id":"","url":"https://api.github.com/users/othiym23","html_url":"https://github.com/othiym23","followers_url":"https://api.github.com/users/othiym23/followers","following_url":"https://api.github.com/users/othiym23/following{/other_user}","gists_url":"https://api.github.com/users/othiym23/gists{/gist_id}","starred_url":"https://api.github.com/users/othiym23/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/othiym23/subscriptions","organizations_url":"https://api.github.com/users/othiym23/orgs","repos_url":"https://api.github.com/users/othiym23/repos","events_url":"https://api.github.com/users/othiym23/events{/privacy}","received_events_url":"https://api.github.com/users/othiym23/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/npm/npm/labels/in%20progress","name":"in progress","color":"ffbb00"},{"url":"https://api.github.com/repos/npm/npm/labels/merge-to-latest","name":"merge-to-latest","color":"eb6420"},{"url":"https://api.github.com/repos/npm/npm/labels/merge-to-lts","name":"merge-to-lts","color":"e11d21"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-12-04T17:10:46Z","updated_at":"2015-12-04T19:34:53Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/npm/npm/pulls/10695","html_url":"https://github.com/npm/npm/pull/10695","diff_url":"https://github.com/npm/npm/pull/10695.diff","patch_url":"https://github.com/npm/npm/pull/10695.patch"},"body":"There are a few issues like #10687 where people think the output of `npm outdated` is wrong. In part this is because the column headings in the output are ambiguous / confusing, but in part that's because the `npm outdated` docs aren't clear about what the output means. I took a whack at cleaning that output up. As I say in #10687, it's hard to come up with pithy column headings that _aren't_ confusing (and, because this is part of the interface of the command, and included in the JSON output of the command that may be used programmatically, changing the label is a semver-major breaking change), so I figured making the docs clearer was a good step for now.\r\n\r\n**r**: @ashleygwilliams \r\n**r**: @iarna"},"comment":{"url":"https://api.github.com/repos/npm/npm/issues/comments/162061487","html_url":"https://github.com/npm/npm/pull/10695#issuecomment-162061487","issue_url":"https://api.github.com/repos/npm/npm/issues/10695","id":162061487,"user":{"login":"ashleygwilliams","id":1163554,"avatar_url":"https://avatars.githubusercontent.com/u/1163554?v=3","gravatar_id":"","url":"https://api.github.com/users/ashleygwilliams","html_url":"https://github.com/ashleygwilliams","followers_url":"https://api.github.com/users/ashleygwilliams/followers","following_url":"https://api.github.com/users/ashleygwilliams/following{/other_user}","gists_url":"https://api.github.com/users/ashleygwilliams/gists{/gist_id}","starred_url":"https://api.github.com/users/ashleygwilliams/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ashleygwilliams/subscriptions","organizations_url":"https://api.github.com/users/ashleygwilliams/orgs","repos_url":"https://api.github.com/users/ashleygwilliams/repos","events_url":"https://api.github.com/users/ashleygwilliams/events{/privacy}","received_events_url":"https://api.github.com/users/ashleygwilliams/received_events","type":"User","site_admin":false},"created_at":"2015-12-04T19:34:53Z","updated_at":"2015-12-04T19:34:53Z","body":"hey! so i def think it should go here, but i also mean that it should go somewhere in the guides so that a full example can be included. a full example is gonna be too long for the cli man pages (i think), and we don't currently have a way to show extended cli pages in the browser version\r\n\r\nmy thought was maybe in `semver` or `using a package.json` or in `publishing a package` or a few notes in each."}}