dotnet / dotnet/docs

Should we provide LTS-to-LTS migration documents?

Open
#40,564 5 comments 1 reaction 1 assignee Claimed by @adegeo View on GitHub
discussion dotnet/svc
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
15h 21m
Merged PRs (30d)
370

Description

### 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

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.