Release notes link in NuGet package is out-of-date

[Eilon]

E.g. go here: https://www.nuget.org/packages/Microsoft.AspNet.WebApi/5.2.6

And there is a link to http://go.microsoft.com/fwlink/?LinkID=403010, which redirects to https://docs.microsoft.com/en-us/aspnet/web-api/overview/releases/whats-new-in-aspnet-web-api-22, which is from 2014.

We should not change the FWLink's target because that will make older packages incorrect.

I recommend we change the Release Notes entry to point to this repo: https://github.com/aspnet/AspNetWebStack and then from there people can get whatever info they want.

[dougbu]

Just to confirm: @Eilon you mean update the .nuspec files?

[Eilon]

@dougbu ultimately the NUSPEC needs to change, yes. But I have no idea how the link ends up there. (Manually edit NUSPEC? CSPROJ? Other script?)

[dougbu]

🆗 the .nuspec files are mostly in TFS but tracking here is fine. There are two .nuspec files in this repo in this repo anyhow.

I'm putting this into 3.2.7. I'm assuming we don't need to rebuild 3.2.6 for this?

[Eilon]

When does 3.2.6 ship? What is its current state?

[dougbu]

3.2.6 is the current release. We don't have a timeline for 3.2.7 yet.

[Eilon]

Maybe I'm confused - then how could we rebuild 3.2.6 if it already shipped?

[dougbu]

Only by overwriting the packages. That would "fix" what shows up on NuGet.org but leave anyone downloading the latest unaffected. (Seems fine because the metadata is primary used on NuGet.org.)

[Eilon]

Packages cannot be overwritten on NuGet.org.

[dougbu]

@Eilon given

• we're fixing the .nuspec files to include <repository> information (NuGet Package : Add repository metadata.  #190),
• we don't have a single location for release notes, and
• https://github.com/aspnet/AspNetWebStack#tags-and-releases is the closest thing in this repo to release notes (yeah, not really),

I propose we remove the <releaseNotes> elements from our .nuspec files. Thoughts?

[Eilon]

Yeah remove release notes. If we link to the repo, whatever we post (if anything) can be found here.

[dougbu]

FYI the old release note links went different places for MVC, Web.API, …:

• https://docs.microsoft.com/en-us/aspnet/web-api/overview/releases/whats-new-in-aspnet-web-api-22
• https://docs.microsoft.com/en-us/aspnet/web-pages/overview/releases/whats-new-in-aspnet-web-pages-32
• https://docs.microsoft.com/en-us/aspnet/mvc/overview/releases/whats-new-in-aspnet-mvc-52
• https://blogs.msdn.microsoft.com/webdev/2014/01/20/announcing-the-release-of-asp-net-mvc-5-1-asp-net-web-api-2-1-and-asp-net-web-pages-3-1/

The last one was a fallback for packages (e.g. Microsoft.AspNet.Facebook.nupkg) not covered elsewhere. But, it was even more out-of-date.

[dougbu]

Done in changeset 1728218