Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: MicrosoftDocs/cpp-docs
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: main
Choose a base ref
...
head repository: MicrosoftDocs/cpp-docs
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: FromPrivateLiveToMaster
Choose a head ref
Checking mergeability… Don’t worry, you can still create the pull request.
  • 2 commits
  • 22 files changed
  • 4 contributors

Commits on Jun 12, 2026

  1. Significantly update C++ modernization agent docs for GA of MSVC upgr… 

    …ade scenario (#6737)

* Copilot CLI's initial implementation of the expansion of GHCP modernization for C++ documentation

* Rename directory from github-copilot-app-modernization-cpp to github-copilot-modernization-cpp and add redirects

* Renaming link to the scenario documentation to match .NET's table of contents

* Modifying some of the text generated by Copilot CLI
- for accuracy
- for closer-to-complete-ness
- for wording choices

* Remove working-with-agent page; add FAQ entry for interacting with the agent

* Add explicit C++ convention and tools tips to FAQ

* Remove upgrade-options references from C++ overview docs

* Update C++ modernization docs minimum VS version to 18.7

* Expanding on tip to explain just how to create a git directory and how to clean up if you don't want it long-term.

* Adding/fixing aka.ms VS download links

* Updating required installer components to use correct names and be more inclusive.

* Clarify explicitly that .uproject codebases are not yet supported

* Improving the Provide feedback section with easy-to-use links

* Expanding on tip to talk about workflow metadata files being in distinct commits to make removal later easier.

* Modifying links to try to resolve automated validation issues

* Simplifying intro paragraph based on feedback

* Efforts to distinguish the General section from the Upgrade section.

This change is to clarify that the modernization agent has a much broader scope than just the MSVC upgrade scenario that we have been working on. It does this by:
- Expanding the explanation about what the agent does in the context of C++ users.
- Renaming the Upgrade section to specifically address the MSVC upgrade scenario

* Updating answer to what the agent actually changes to more clearly define what it means to fix conformance issues.

Also fixes some terminology around headers and include directives and qualifies git commit behavior on actually having the project in a git repository.

* Being clearer on the sequence of steps in the answer on how to correct mistakes made by the agent.

* Simplified answer for needing a Copilot subscription

* Slightly moving the exclusion of .uproject so that it's colocated with the mention of the Game development workload.

* Fixing links

* Remove potential commitment of future work that we haven't decided to do yet.

* Fixing links

* Removing unnecessary header

* Rewording the sections describing what/how the MSVC upgrade scenarios complete the task

* Adding example of an STL change that the agent can fix

* Removing 'also'

* Fixing links

* Wording change about the MSVC scenario building your product

* Providing more information on how to document known build issues for the agent

* Wording change "may" -> "can"

* Explaining to the user how to actually stop the agent and redirect it

* Making it clearer that the text is suggesting prompts to use.

* Updating a related page to link to the agent overview.

* Making it clearer that the text shows 2 different ways to start the agent.

* Removing 'Alternatively'

* Collapse the note into the preceding paragraph as normal text.

* Providing better instructions on how to switch between Automatic and Guided modes.

* Removing additional "collaboration" rationale since "doing other work" covers it.

* Adding top-level heading by moving all headings up 1 level.

* Replacing text that potentially promises future changes with verbiage used elsewhere and fixing the Developer Community link

* Fixing links

* Moving question about supported projects that are specific to the MSVC upgrade scenario to that section of the FAQ

* Changing language from "deals with" to "helps with"

* Revert "Adding top-level heading by moving all headings up 1 level."

This reverts commit 7a10ee7c5e9c7cf8f6a9b3bc61ee66a64065cab4.

* Previous attempt at resolving top-level header issue failed because you can't have multiple top-level headers. Adding one that matches what the .NET docs did here.

* Adding a walkthrough/tutorial on using the modernization agent to upgrade an old C++ sample to use a newer MSVC version

* Removing incorrect (and incorrectly formatted) image of the enabling setting.

* Rewriting proposed example prompts to avoid the impression that they will install the latest MSVC build tools.

* Adding note about not supporting .uproject in the FAQ.

* Removing trailing slash from directory name

* Fixing typo 'commited' >> 'committed'

* Removing duplicated line

* Rephrasing prompt to get list of scenarios.

* Removing 'If necessary' language.

* Clarifying that "latest" means the "latest, installed" version.

* Using "For example" language.

* Fixing typo "build" >> "building"

* Providing more context for the troubleshooting tip for the agent not showing up.

* Turning "Cancel button" into "cancel button" since the button doesn't have "Cancel" on it's label.

* Fixing misplaced comma

* Fixing prompt quotation style

* Removing image with malformed name. A replacement has already been added.

* Removing link to image that I didn't add.

* Fixing numerous Acrolinx suggestions for the Hilo walkthrough.

* A few more Acrolinx suggestions that were missed or new based on new text.

* Adding an introductory paragraph to the installation instructions page.

* Moving the note on missing .uproject support back to the line talking about supported project types as just an additional sentence.

The alternatives seemed less good:
- Drop it entirely
- Insert a `> [!NOTE]` in the middle of a bulleted list
- Move the required components to the bottom, separating it from the VS version requirement (and nominally "out of order")

* Fixing spelling mistake with 'environment'

* Updating alt text for images to clearly indicate they are screenshots.

* Adding intro paragraph at top of Hilo walkthrough doc.

* Renaming image files with some additional '-' separators between parts of the filename.

* Addressing remaining reviewer feedback.

* Renaming Setup Assistant image file back to walkthrough-hilo-setup-assistant.png

* Fixing 'an' -> 'a'

* address PR review feedback

* address PR feedback

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Tyler Whitney <TylerMSFT@users.noreply.github.com>
    @michaelbprice @TylerMSFT
    3 people authored Jun 12, 2026
    Configuration menu
    Copy the full SHA
    2412558 View commit details
    Browse the repository at this point in the history

  2. Merge pull request #6745 from MicrosoftDocs/main 

    Auto Publish – main to live - 2026-06-12 17:31 UTC
    @learn-build-service-prod
    learn-build-service-prod[bot] authored Jun 12, 2026
    Configuration menu
    Copy the full SHA
    6204694 View commit details
    Browse the repository at this point in the history
Loading