Document ef6.exe and retire migrate.exe guidance

[Copilot]

The migration utility documentation described the obsolete migrate.exe workflow and incorrectly stated that SQL scripts could not be generated. The team-environment guide also lacked working links to its migration screencasts.

• EF6 command-line tooling
  • Replace the migrate.exe page with ef6.exe database update guidance.
  • Document NuGet cache discovery, common commands, SQL script generation, and legacy option equivalents.
  • Update navigation and references, with a redirect from the previous URL.

ef6.exe database update --assembly MyApp.dll --script > migration.sql

• FixesDocument ef6.exe and remove doc for migrate.exe #1740

[Copilot]

Pull request overview

This PR updates the EF6 documentation set to retire the obsolete migrate.exe guidance and replace it with ef6.exe database update documentation, along with navigation/reference updates and a redirect from the previous URL.

Changes:

• Replaced the migrate.exe documentation page with a new ef6.exe page covering common migration scenarios and SQL script generation.
• Updated EF6 navigation (TOC) and “past releases” references to point to the new ef6.exe page.
• Added an Open Publishing redirect from the removed migrate-exe.md URL to the new ef6-exe page.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
entity-framework/toc.yml	Swaps the “Use Migrate.exe” nav entry to “Use ef6.exe”.
entity-framework/ef6/what-is-new/past-releases.md	Updates the EF5 resource list link from migrate-exe to ef6-exe.
entity-framework/ef6/modeling/code-first/migrations/migrate-exe.md	Removes the obsolete migrate.exe guidance page.
entity-framework/ef6/modeling/code-first/migrations/ef6-exe.md	Adds new ef6.exe database update documentation including script generation and option mapping.
.openpublishing.redirection.json	Redirects the old migrate-exe.md path to the new ef6-exe URL.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

🟡 Changes recommended

The new ef6.exe documentation and PR scope statement need small but important clarity/scope corrections before publishing.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

Suppressed comments (2)

Previously missed (1) — in code that hasn't changed since the last review.

entity-framework/ef6/modeling/code-first/migrations/ef6-exe.md:23

• The global packages folder path is configurable (for example via NUGET_PACKAGES), so hardcoding %USERPROFILE%\.nuget\packages\... can be misleading. Consider adding a command readers can use to discover the actual global packages folder, and clarify that the tools\<tfm>\<rid> portion may vary by EF version.

entity-framework/toc.yml:642

• The PR description mentions fixing “working links to its migration screencasts” in the team-environment guide, but this PR only updates the TOC entry and doesn’t appear to update the team-environment content (and teams.md currently contains no screencast links). Either update the description to match the actual scope, or include the intended teams.md link fixes in this PR.

 - name: Use ef6.exe
href: ef6/modeling/code-first/migrations/ef6-exe.md
- name: Migrations in team environments
href: ef6/modeling/code-first/migrations/teams.md

• Files reviewed: 5/5 changed files
• Comments generated: 1
• Review effort level: Lite

[Copilot]

🟡 Changes recommended

The new documentation has a couple of content/consistency issues and at least one stated PR goal (team-environment guide link fixes) is not reflected in the actual file changes.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

Suppressed comments (3)

Previously missed (2) — in code that hasn't changed since the last review.

entity-framework/ef6/modeling/code-first/migrations/ef6-exe.md:23

• This section mentions the global packages folder but doesn’t explain how to discover it (the PR description explicitly calls out “NuGet cache discovery”). Consider adding the dotnet nuget locals global-packages --list command so readers can find the actual path on their machine.
  entity-framework/ef6/what-is-new/past-releases.md:176
• This list is under the EF 5 release section, but the link text ef6.exe implies the EF6-specific tool existed in EF5. To avoid historical confusion, consider renaming the link text to indicate it’s about command-line migrations tooling (including the legacy migrate.exe workflow).

entity-framework/toc.yml:640

• The PR description mentions fixing broken links in the “Migrations in team environments” guide, but this PR doesn’t include any changes to ef6/modeling/code-first/migrations/teams.md. Either update that page as part of this PR or adjust the PR description/scope accordingly.

 - name: Use ef6.exe
href: ef6/modeling/code-first/migrations/ef6-exe.md

• Files reviewed: 5/5 changed files
• Comments generated: 1
• Review effort level: Lite

[Copilot]

🟡 Changes recommended

There are documentation inconsistencies and a scope mismatch with the PR description that should be resolved before merging.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

Suppressed comments (1)

entity-framework/toc.yml:640

• The PR description mentions fixing broken migration screencast links in the team-environment guide, but this PR doesn’t include any changes to the team environments page. Either update the PR description to match scope, or include the intended fix in the relevant doc page.

 - name: Use ef6.exe
href: ef6/modeling/code-first/migrations/ef6-exe.md

• Files reviewed: 5/5 changed files
• Comments generated: 1
• Review effort level: Lite

[Copilot]

🔵 Needs a closer look

The new ef6.exe page includes an incorrect NuGet global-packages path example for locating ef6.exe, which can mislead readers.

Review details

Suppressed comments (1)

Previously missed (1) — in code that hasn't changed since the last review.

entity-framework/ef6/modeling/code-first/migrations/ef6-exe.md:20

• The sample global-packages path for ef6.exe looks incorrect: the EntityFramework NuGet package places ef6.exe under the tools\\net45\\any folder (not tools\\net45\\win-x86). As written, readers may look in a non-existent folder and assume the tool is missing.

• Files reviewed: 5/5 changed files
• Comments generated: 0 new
• Review effort level: Lite