Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Should we provide LTS-to-LTS migration documents? #40564

Open
adegeo opened this issue Apr 19, 2024 · 2 comments
Open

Should we provide LTS-to-LTS migration documents? #40564

adegeo opened this issue Apr 19, 2024 · 2 comments
Labels
discussion Indicates issues that are being discussed doc-idea Indicates issues that are suggestions for new topics [org][type][category] dotnet/svc Pri3

Comments

@adegeo
Copy link
Contributor

adegeo commented Apr 19, 2024

Describe the issue or suggestion

A customer recently contacted Microsoft recently asking about migration notes between LTS versions. While we do document version-to-version, we don't document LTS-to-LTS. Customers will choose LTS versions of .NET because of the long support guarantee. This customer in particular is tasked with upgrading production apps of various technologies (.NET MAUI, ASP.NET Core, etc) from .NET 6 to .NET 8. Providing migration details between LTS versions seems like a good thing to document.

Trying to follow the notes from .NET 6 to .NET 7, and then from .NET 7 to .NET 8, might be overwhelming and hard to follow. Also, consider that some may not even upgrade to .NET 8, even when support for .NET 6 ends. They may just upgrade when something breaks. In the future it could be possible that a customer is migrating from .NET 6 to .NET 10. Having to go through 6 -> 7 -> 8 -> 9 -> 10 release notes would be difficult. But with LTS-to-LTS they would just be going through 6 -> 8 -> 10 which is more manageable.

@gewarren @jamshedd

@adegeo adegeo added the discussion Indicates issues that are being discussed label Apr 19, 2024
@dotnet-bot dotnet-bot added the ⌚ Not Triaged Not triaged label Apr 19, 2024
@adegeo adegeo changed the title Should we point out the differences between LTS versions? Should we provide LTS-to-LTS migration documents? Apr 19, 2024
@adegeo adegeo added doc-idea Indicates issues that are suggestions for new topics [org][type][category] dotnet/svc and removed ⌚ Not Triaged Not triaged labels Apr 19, 2024
@AClerbois
Copy link

Thank you @adegeo for the follow up :-)

I think the migration through LTS is a good alternative :-)

@gewarren
Copy link
Contributor

@adegeo When you say migration notes, do you mean the breaking change docs like these?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
discussion Indicates issues that are being discussed doc-idea Indicates issues that are suggestions for new topics [org][type][category] dotnet/svc Pri3
Projects
None yet
Development

No branches or pull requests

4 participants