Migration guide TOC design
- Dominant language
- No language data
- Stars
- 4.8k
- Forks
- 6.1k
- Avg merge
- 15h 21m
- Merged PRs (30d)
- 370
Description
The intent for this TOC is to display migration data and information in a logical structure that mimics what we believe is the most common migration path.
We hope this does 2 things...
1. Documentation is easier to find.
2. The layout of the information itself provides an overview of the entire migration process.
This TOC is a "living" doc meaning that it is not static and complete as is, but if done correctly it should be obvious and easy to see where new content should be plugged in.
Please provide feedback and recommendations for needed content in the comments.
Phase 1 is the minimal set of initial changes needed to map existing content to the new TOC structure.
Once the Phase 1 plan has been approved, issues will be opened for the needed work and assigned.
### Please do not edit the TOC directly, provide your feedback via comments.
For more about this overall effort: [Migration Guide Documentation Revamp](https://github.com/dotnet/docs/issues/23561)
Project tracking this effort: [Migration Guide Project](https://github.com/dotnet/docs/projects/128)
***
- [ ] Migration Guide
- [ ] Overview (#25237)
- [ ] General Information
- [ ] .NET Overview (#25240)
- [ ] .NET Framework, .NET Standard & .NET Core (#25239)
- [ ] Compatibility and Breaking Changes (#25241)
- [ ] .NET Releases and Servicing Support (#25242)
- [x] Versioning relationship between the .NET SDK, MSBuild and VS [#24568 - **Phase 1**]
- [x] Choose between .NET 5 and .NET Framework for server apps [#24582 - **Phase 1**]
- [ ] Windows to Cross Platform (#25245)
- [ ] Reasons for Porting (#25246)
- [x] .NET Upgrade Assistant tool [#24561 - **Phase 1**]
- [x] Overview
- [x] Windows Presentation Foundation
- [x] Windows Forms
- [x] ASP.NET Core
- [ ] Recommended Blogs (#25247)
- [ ] Case Studies (#25248)
- [ ] Pre-Migration
- [ ] Asses the portability of your project
- [ ] Overview (#25249)
- [ ] Visual Basic Considerations (#25251)
- [x] Unsupported dependencies [#24567 - **Phase 1**]
- [x] Dependency on Windows APIs [#24576 - **Phase 1**]
- [x] Unavailable technologies [#24575 **Phase 1**]
**Phase 2**: Add VB Razor story
- [x] Unsupported APIs [#24570 - **Phase 1**]
-Feature re-writes
- [ ] Needed changes before porting code (#25252)
- [ ] Create a porting plan (#25253)
- [ ] Overview
- What TFM should you be targeting?
- [ ] Approaches
- [ ] Project structure
- [ ] .NET Framework compatibility mode
- [ ] Testing strategy
- [ ] Deployment considerations
- [ ] Migration
- [ ] Overview
- [ ] Simple changes first
- Overview
- Roslyn analyzers & code fixers
- Known 1to1 API mappings
- [ ] Unavailable technologies
- Overview
- List of unavailable technologies with replacement recommendations and links to guides
- [ ] Application Porting Guides
- [ ] Overview
- [ ] WebAPI/ASP.NET
- [ ] Add VB Razor story
- [ ] Windows Forms [#24578 - **Phase 1**]
- [ ] Windows Presentation Foundation [#24579 - **Phase 1**]
- [ ] C++/CLI [#24580 - **Phase 1**]
- [ ] WCF
- [ ] Packaging
- [ ] Overview
- [ ] Producing your own packages
- [ ] Consuming other's packages
- [ ] Post-Migration
- [ ] Overview
- [ ] Deployment
- Leverage [Existing Deployment Docs](https://docs.microsoft.com/en-us/dotnet/core/deploying/) (page content)
- Add content learned from 1st and 3d party migration experiences
- Implications of [Breaking Changes](https://docs.microsoft.com/en-us/dotnet/core/compatibility/) on deployment scenarios such as [roll forwarding](https://docs.microsoft.com/en-us/dotnet/core/versions/selection#framework-dependent-apps-roll-forward)
- [ ] Servicing updates
- Leverage any existing content
- Add content learned from 1st and 3d party migration experiences
- [ ] Moving to latest
- Leverage existing content such as [NET Core Releases and Support](https://devblogs.microsoft.com/dotnet/net-core-releases-and-support/)
Contributor guide
Assessment
This issue has not been assessed yet.