angular/angular-update-guide

[Bug]: contradictory recommendations in across multiple versions updates

bougwal opened this issue · 0 comments

Since the property duringRecommendations is being set conditionally dynamically based on the user input, when users pick across major versions options, for example: From v11 to v14, different dependency / packages versions are being pushed to the duringRecommendations array and mapped to the UI. This is very confusing for users (especially, people new to Angular) as they see something like this:

bug

The lesser the From parameter value is (i.e the wider the gap between versions) the longer and more confusing the list of recommendations is.

Examples links:

Since there is a warning shown to the user indicating that "We do not support migrating across multiple major versions at once"
I think it is a potentially acceptable solution to remove across multiple versions recommendation and show the warning in place of this section. Or to add a header to every part of the across multiple major versions recommendations to remove the contradiction and confusion.