Update documentation on target framework updates#52855
Update documentation on target framework updates#52855marcpopMSFT wants to merge 1 commit intomainfrom
Conversation
Expanded the document to summarize the work required for updating target framework versions, including large updates and miscellaneous tasks. Added example PRs and a section for Net7 TFM updates.
There was a problem hiding this comment.
Pull request overview
This PR expands the documentation on updating target framework versions, making it more comprehensive and structured for future TFM updates. The changes provide a high-level summary of required work and preserve historical information about the Net7 update as a reference.
Changes:
- Added a comprehensive summary section covering large updates (branding, KnownFrameworkReference, retargeting, test updates, templates) and miscellaneous tasks
- Added example PRs from the net11 update to provide concrete references
- Reorganized existing Net7 update information under a clearly labeled subsection
|
|
||
| **Miscellaneous** | ||
| - Fix versions after the N-1 GA as there should be RC placeholders | ||
| - Likely will need to ping to N-1 templates |
There was a problem hiding this comment.
The word "ping" should be "pin" in this context. The sentence should read "Likely will need to pin to N-1 templates."
| - Likely will need to ping to N-1 templates | |
| - Likely will need to pin to N-1 templates |
| Example PRs from net11 update | ||
| [Backflow from VMR](https://github.com/dotnet/sdk/pull/52242) | ||
| [unwind test changes](https://github.com/dotnet/sdk/pull/52512) | ||
| [Branding](https://github.com/dotnet/sdk/pull/50468) | ||
| [BundledVersions](https://github.com/dotnet/sdk/pull/50329) |
There was a problem hiding this comment.
This section header is inconsistently formatted. It should have a title format like "## Example PRs from net11 update" (with proper capitalization and consistent structure) or formatted as a list item. The following lines (28-31) should also be properly formatted as a bulleted list for consistency.
| Example PRs from net11 update | |
| [Backflow from VMR](https://github.com/dotnet/sdk/pull/52242) | |
| [unwind test changes](https://github.com/dotnet/sdk/pull/52512) | |
| [Branding](https://github.com/dotnet/sdk/pull/50468) | |
| [BundledVersions](https://github.com/dotnet/sdk/pull/50329) | |
| ### Example PRs from net11 update | |
| - [Backflow from VMR](https://github.com/dotnet/sdk/pull/52242) | |
| - [unwind test changes](https://github.com/dotnet/sdk/pull/52512) | |
| - [Branding](https://github.com/dotnet/sdk/pull/50468) | |
| - [BundledVersions](https://github.com/dotnet/sdk/pull/50329) |
| - Recommend doing in the VMR and fixing tests on backflow | ||
| - We had to disable a bunch of tests to merge the branding flow | ||
| - [KnownFrameworkReference](https://github.com/dotnet/sdk/blob/main/src/Layout/redist/targets/BundledTemplates.targets) update | ||
| - Should be wrote but tricky to get right |
There was a problem hiding this comment.
The word "wrote" should be "rote" (meaning a fixed, habitual, or mechanical course of procedure) in this context. The sentence should read "Should be rote but tricky to get right."
| - Should be wrote but tricky to get right | |
| - Should be rote but tricky to get right |
1 participant
Expanded the document to summarize the work required for updating target framework versions, including large updates and miscellaneous tasks. Added example PRs and a section for Net7 TFM updates.