Restore Azure Migrate functionality descriptions in FinOps documentation #1797
Conversation
microsoft-github-policy-service
bot
requested review from
aromano2,
arthurclares and
flanakin
microsoft-github-policy-service
bot
added
the
Skill: DevOps
microsoft-github-policy-service
bot
added
Skill: Documentation
Co-authored-by: arthurclares <[email protected]>
Copilot
AI
changed the title
There was a problem hiding this comment.
This is what needs to be changed and removed
This page: https://learn.microsoft.com/en-us/cloud-computing/finops/framework/quantify/planning#getting-started
Use the Total Cost of Ownership (TCO) Calculator to get a high-level comparison of on-premises vs. cloud servers, databases, storage, and networking infrastructure.
After entering details of your on-premises infrastructure, the TCO Calculator presents cost reports showcasing the cost differences between running workloads on-premises compared to Azure that can be saved and shared across team members.
TCO Calculator: Allows you to estimate the cost savings achievable by migrating your application workloads to Microsoft Cloud.
| If you're migrating on-premises infrastructure to the cloud, you might also be interested in: | ||
|
|
||
| - **Azure Migrate**: Discover, migrate, and modernize on-premises infrastructure. Estimate the cost savings achievable by migrating your application to Microsoft Cloud. | ||
| - **Azure Migrate**: Discover, migrate, and modernize on-premises infrastructure. |
There was a problem hiding this comment.
This doesn't need to be removed. Keep it as is.
There was a problem hiding this comment.
Fixed in dae7ea3. The Azure Migrate description has been restored to include the cost estimation functionality: "Estimate the cost savings achievable by migrating your application to Microsoft Cloud."
|
|
||
| - If you're migrating on-premises infrastructure to the cloud: | ||
| - Use [Azure Migrate](https://azure.microsoft.com/products/azure-migrate) to automate the discovering and migration of your on-premises workloads and get an estimate comparison of on-premises vs. Azure costs. | ||
| - Use [Azure Migrate](https://azure.microsoft.com/products/azure-migrate) to discover and assess your on-premises workloads for migration to Azure. |
There was a problem hiding this comment.
Azure Migrate is still a valid tool with the same functionalities as before. Keep it as is.
There was a problem hiding this comment.
Fixed in dae7ea3. The Azure Migrate description has been restored to include the original functionality: "automate the discovering and migration of your on-premises workloads and get an estimate comparison of on-premises vs. Azure costs."
microsoft-github-policy-service
bot
added
Needs: Attention 👋
There was a problem hiding this comment.
Pull Request Overview
This PR removes references to TCO (Total Cost of Ownership) calculator functionality from FinOps framework documentation in preparation for the Azure TCO calculator's retirement on August 31, 2025. The changes ensure users aren't directed to deprecated cost comparison tools while maintaining focus on Azure Migrate's core migration capabilities.
Key changes:
- Removed TCO-style cost comparison references from Azure Migrate descriptions
- Updated documentation to focus on discovery and assessment capabilities
- Added changelog entry documenting the removal of deprecated functionality
Reviewed Changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs-mslearn/toolkit/changelog.md | Added documentation update entry for TCO reference removal |
| docs-mslearn/framework/quantify/planning.md | Removed cost comparison language from Azure Migrate description |
| docs-mslearn/framework/manage/tools-services.md | Simplified Azure Migrate description to focus on core capabilities |
docs-mslearn/toolkit/changelog.md
Outdated
|
|
||
| ### Documentation improvements | ||
|
|
||
| - **Updated** FinOps framework documentation to remove references to TCO-style cost comparison functionality due to Azure TCO calculator retirement scheduled for August 31, 2025. |
There was a problem hiding this comment.
This changelog entry should be documented under the next release version (v13) rather than in a general 'Documentation improvements' section. According to the coding guidelines, every change must have a changelog entry under the correct tool and version.
Copilot generated this review using guidance from repository custom instructions.
| If you're migrating on-premises infrastructure to the cloud, you might also be interested in: | ||
|
|
||
| - **Azure Migrate**: Discover, migrate, and modernize on-premises infrastructure. Estimate the cost savings achievable by migrating your application to Microsoft Cloud. | ||
| - **Azure Migrate**: Discover, migrate, and modernize on-premises infrastructure. |
|
|
||
| - If you're migrating on-premises infrastructure to the cloud: | ||
| - Use [Azure Migrate](https://azure.microsoft.com/products/azure-migrate) to automate the discovering and migration of your on-premises workloads and get an estimate comparison of on-premises vs. Azure costs. | ||
| - Use [Azure Migrate](https://azure.microsoft.com/products/azure-migrate) to discover and assess your on-premises workloads for migration to Azure. |
docs-mslearn/toolkit/changelog.md
Outdated
|
|
||
| ### Documentation improvements | ||
|
|
||
| - **Updated** FinOps framework documentation to remove references to TCO-style cost comparison functionality due to Azure TCO calculator retirement scheduled for August 31, 2025. |
Co-authored-by: MSBrett <[email protected]>
I've restored the Azure Migrate functionality as requested. However, I don't see the specific TCO Calculator references you mentioned in the current repository files. The URLs you referenced may be on the published Microsoft Learn site but not in this source repository. Could you clarify if these specific TCO Calculator references exist in this repository, or if they need to be addressed through a different process? |
microsoft-github-policy-service
bot
removed
the
Needs: Attention 👋
microsoft-github-policy-service
bot
added
the
Needs: Triage 🔍
Copilot
AI
changed the title
5 participants
Based on feedback, this PR restores the original Azure Migrate functionality descriptions that were previously removed. The Azure Migrate tool provides cost estimation capabilities that are separate from the standalone TCO Calculator being retired.
Changes Made
Restored Azure Migrate descriptions to original state:
docs-mslearn/toolkit/changelog.md:
Impact
Azure Migrate's built-in cost estimation capabilities remain intact and available to users. The tool provides migration discovery, assessment, and cost comparison functionality that is independent of the standalone TCO Calculator tool scheduled for retirement.
Addresses feedback in #1796.
💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.