{"action":"created","issue":{"url":"https://api.github.com/repos/NuGet/Home/issues/1195","labels_url":"https://api.github.com/repos/NuGet/Home/issues/1195/labels{/name}","comments_url":"https://api.github.com/repos/NuGet/Home/issues/1195/comments","events_url":"https://api.github.com/repos/NuGet/Home/issues/1195/events","html_url":"https://github.com/NuGet/Home/issues/1195","id":101344163,"number":1195,"title":"release notes and blogs do not equate to documentation","user":{"login":"SimonCropp","id":122666,"avatar_url":"https://avatars.githubusercontent.com/u/122666?v=3","gravatar_id":"","url":"https://api.github.com/users/SimonCropp","html_url":"https://github.com/SimonCropp","followers_url":"https://api.github.com/users/SimonCropp/followers","following_url":"https://api.github.com/users/SimonCropp/following{/other_user}","gists_url":"https://api.github.com/users/SimonCropp/gists{/gist_id}","starred_url":"https://api.github.com/users/SimonCropp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SimonCropp/subscriptions","organizations_url":"https://api.github.com/users/SimonCropp/orgs","repos_url":"https://api.github.com/users/SimonCropp/repos","events_url":"https://api.github.com/users/SimonCropp/events{/privacy}","received_events_url":"https://api.github.com/users/SimonCropp/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/NuGet/Home/labels/Priority:1","name":"Priority:1","color":"fbca04"},{"url":"https://api.github.com/repos/NuGet/Home/labels/Type:Docs","name":"Type:Docs","color":"207de5"}],"state":"closed","locked":false,"assignee":{"login":"csharpfritz","id":78577,"avatar_url":"https://avatars.githubusercontent.com/u/78577?v=3","gravatar_id":"","url":"https://api.github.com/users/csharpfritz","html_url":"https://github.com/csharpfritz","followers_url":"https://api.github.com/users/csharpfritz/followers","following_url":"https://api.github.com/users/csharpfritz/following{/other_user}","gists_url":"https://api.github.com/users/csharpfritz/gists{/gist_id}","starred_url":"https://api.github.com/users/csharpfritz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/csharpfritz/subscriptions","organizations_url":"https://api.github.com/users/csharpfritz/orgs","repos_url":"https://api.github.com/users/csharpfritz/repos","events_url":"https://api.github.com/users/csharpfritz/events{/privacy}","received_events_url":"https://api.github.com/users/csharpfritz/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/NuGet/Home/milestones/11","html_url":"https://github.com/NuGet/Home/milestones/3.3.0","labels_url":"https://api.github.com/repos/NuGet/Home/milestones/11/labels","id":1057211,"number":11,"title":"3.3.0","description":"The first major update for NuGet extension targeted to around Visual Studio Update I timeframe.\r\n\r\nThis release includes bug fixes, new features, and UI refresh for NuGet.\r\n\r\nDate is tentative","creator":{"login":"yishaigalatzer","id":1238711,"avatar_url":"https://avatars.githubusercontent.com/u/1238711?v=3","gravatar_id":"","url":"https://api.github.com/users/yishaigalatzer","html_url":"https://github.com/yishaigalatzer","followers_url":"https://api.github.com/users/yishaigalatzer/followers","following_url":"https://api.github.com/users/yishaigalatzer/following{/other_user}","gists_url":"https://api.github.com/users/yishaigalatzer/gists{/gist_id}","starred_url":"https://api.github.com/users/yishaigalatzer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yishaigalatzer/subscriptions","organizations_url":"https://api.github.com/users/yishaigalatzer/orgs","repos_url":"https://api.github.com/users/yishaigalatzer/repos","events_url":"https://api.github.com/users/yishaigalatzer/events{/privacy}","received_events_url":"https://api.github.com/users/yishaigalatzer/received_events","type":"User","site_admin":false},"open_issues":31,"closed_issues":172,"state":"open","created_at":"2015-04-07T20:54:03Z","updated_at":"2015-11-25T20:43:50Z","due_on":"2015-11-30T08:00:00Z","closed_at":null},"comments":6,"created_at":"2015-08-17T05:49:04Z","updated_at":"2015-11-25T21:31:02Z","closed_at":"2015-11-25T20:43:50Z","body":"Ok this has been going on for a long time and i think it needs to be called out as bad practice. \r\n\r\nToo often changes occur in nuget (often breaking changes) and while it is publicized in release notes and/or blogs the documentation is updated much later or never at all\r\n\r\nSome recent examples\r\n\r\nSo this talks about dependencyversion\r\nhttps://docs.nuget.org/release-notes/nuget-2.8#dependencyversion-attribute\r\nBut not this \r\nhttps://docs.nuget.org/consume/nuget-config-settings\r\n\r\nThis http://blog.nuget.org/20150729/Introducing-nuget-uwp.html\r\n-talks about install.ps1/uninstall.ps1 being deprecated but this still says it is a supported feature http://docs.nuget.org/create/Creating-and-Publishing-a-Package\r\n-talks about content delivery being deprecated but this still says it is a supported feature http://docs.nuget.org/Create/Enforced-Package-Conventions\r\n\r\nYour definition of done should first favor updating the doco and then doing the marketing "},"comment":{"url":"https://api.github.com/repos/NuGet/Home/issues/comments/159735648","html_url":"https://github.com/NuGet/Home/issues/1195#issuecomment-159735648","issue_url":"https://api.github.com/repos/NuGet/Home/issues/1195","id":159735648,"user":{"login":"csharpfritz","id":78577,"avatar_url":"https://avatars.githubusercontent.com/u/78577?v=3","gravatar_id":"","url":"https://api.github.com/users/csharpfritz","html_url":"https://github.com/csharpfritz","followers_url":"https://api.github.com/users/csharpfritz/followers","following_url":"https://api.github.com/users/csharpfritz/following{/other_user}","gists_url":"https://api.github.com/users/csharpfritz/gists{/gist_id}","starred_url":"https://api.github.com/users/csharpfritz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/csharpfritz/subscriptions","organizations_url":"https://api.github.com/users/csharpfritz/orgs","repos_url":"https://api.github.com/users/csharpfritz/repos","events_url":"https://api.github.com/users/csharpfritz/events{/privacy}","received_events_url":"https://api.github.com/users/csharpfritz/received_events","type":"User","site_admin":false},"created_at":"2015-11-25T21:31:02Z","updated_at":"2015-11-25T21:31:02Z","body":"The other item about DependencyVersion was addressed in an commit\nNuGet/NuGetDocs#372\n\n\n\nJeff\n\n\n\nOn Wed, Nov 25, 2015 at 4:16 PM, Simon Cropp <notifications@github.com>\nwrote:\n\n> I notice u olny linked one commit. Can u please also link the other\n> commits that fix the several other examples i mentioned\n>\n> —\n> Reply to this email directly or view it on GitHub\n> <https://github.com/NuGet/Home/issues/1195#issuecomment-159733211>.\n>\n"}}