umbraco / Umbraco.Marketplace.Issues

Public issue tracker for Umbraco Marketplace
2 stars 0 forks source link

Show release notes #59

Open ronaldbarendse opened 1 year ago

ronaldbarendse commented 1 year ago

Discussed in https://github.com/umbraco/Umbraco.Packages/discussions/117

Originally posted by **patrickdemooij9** May 11, 2021 Usually, when I do an update for packages, I also add the release notes to the description so that people know what has actually changed. However, I feel that the description might not be the best place for this. Especially if you look at some older packages, you can see that there is a long list of updates (https://our.umbraco.com/packages/developer-tools/umbraco-forms/). That just makes the page a lot harder to read. I think that adding a Releases tab somewhere would be a nice idea. The release tab would list all the different updates for the package. (maybe also have filters for Umbraco versions so that we can also switch between V7, V8, V9 releases). Each of those updates could then include the things that have changed and maybe also the Umbraco package for that update if you ever need to switch back.

NuGet packages support including version-specific release notes, but those are not displayed on the Marketplace. The umbraco-marketplace.json file also doesn't have a property to specify a release notes URL.

The linked discussion is therefore still valid, as we want to avoid users adding the full version history in the package description/readme.