v16.0.4-Preview.3 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.3

Version: 16.0.4-Preview.3
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several enhancements, bug fixes, and documentation updates aimed at improving the overall functionality and user experience. The changes reflect our commitment to providing a robust and user-friendly tool for migrating work items and managing configurations effectively.

Detailed Changes

New Features, ✨

• Support for IsKeyed Configuration Metadata: The ClassDataLoader.cs file now includes support for IsKeyed configuration metadata, enhancing the flexibility of configuration management. This feature allows users to better define and manage their data structures, which is crucial for complex migration scenarios. PR #2377

Enhancements, 💡

• Warning Log for Disabled Node Structure Enricher: A warning log is added in TfsNodeStructureTool.cs to notify users when the node structure enricher is disabled. This improvement helps users understand the state of their configuration and avoid potential issues during migration.
• Validation Logic Enhancements: The validation logic for TfsWorkItemMigrationProcessorOptions is enhanced to provide clearer error messages, ensuring users can quickly identify and rectify configuration issues. This is part of a broader effort to improve user experience and reduce errors during migration.

Bug Fixes, 🐛

• Fix for Incorrect Type Registration: The ServiceCollectionExtensions.cs file is updated to correct the type registration for TfsWorkItemMigrationProcessorOptions, resolving issues that could lead to incorrect behaviour during migrations.
• Configuration Validation Exception Fixes: The ConfigurationValidationException class is updated to fix property names and add constructor overloads, ensuring that exceptions are thrown correctly for missing endpoints.

Performance Improvements, ⚡️

• Refactoring for Improved Validation Logic: The validation logic is refactored across several classes, including TfsWorkItemMigrationProcessorOptions and ProcessorOptions, to streamline the validation process and enhance performance. This refactoring reduces redundancy and improves maintainability.

Refactoring, ♻️

• Code Structure Improvements: Several classes, including TfsProcessor.cs and TfsWorkItemMigrationProcessorOptions, undergo refactoring to improve code structure and readability. This includes integrating validation logic into the ProcessorOptions class and removing redundant classes, which simplifies the codebase and enhances maintainability.

Documentation Updates, 📝

• Updated Documentation: The documentation in MigrationTools.xml is updated to reflect the latest changes, including new branch and commit details. This ensures that users have access to the most current information regarding the tool's functionality and usage.
• Error Messages Enhancement: Error messages in TfsTeamProjectAuthentication.cs and TfsEndpointOptions.cs are updated to include links to relevant documentation, providing users with immediate access to help resources when encountering issues.

Dependency Updates, 📌

• Configuration Updates: The configuration.json file is updated to rename endpoint keys for clarity, ensuring that users can easily understand and configure their endpoints.

Other, 🧱

• Logging Improvements: A new warning log is introduced when the node structure enricher is disabled, providing users with better insights into their configuration state.

Conclusion

The changes in this release significantly enhance the Azure DevOps Migration Tools, making it more user-friendly and efficient. By addressing bugs, improving validation logic, and updating documentation, we aim to reduce user errors and streamline the migration process. These updates not only improve the tool's performance but also align with our business goals of delivering high-quality software that meets the needs of our users. We look forward to continued improvements and user feedback as we evolve the tool further.

Get the tools

• Download the MigrationTools-16.0.4-Preview.3.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.3 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.4-preview0003. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Fix for Endpoint Samples not being rendered correctly in Docs by @MrHinsh in #2377

Full Changelog: v16.0.4-Preview.2...v16.0.4-Preview.3

v16.0.4-Preview.2 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.2

Version: 16.0.4-Preview.2
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several enhancements, bug fixes, and documentation updates aimed at improving the overall functionality and user experience. The changes focus on refining validation processes, enhancing logging capabilities, and updating documentation to ensure clarity and accuracy.

Detailed Changes

New Features, ✨

• ConfigurationValidationException: A new exception type is introduced in TfsProcessor.cs to handle invalid endpoint types more effectively. This addition enhances error handling and provides clearer feedback to users when configuration issues arise.
• IValidateOptions Implementation: The NetworkCredentialsOptions, TfsAuthenticationOptions, TfsEndpointOptions, TfsLanguageMapOptions, and TfsWorkItemMigrationProcessorOptions classes now implement the IValidateOptions interface, allowing for more robust validation of configuration options.

Enhancements, 💡

• Warning Log for Disabled Enricher: A warning log is added in TfsNodeStructureTool.cs to notify users when the node structure enricher is disabled. This improvement helps users understand the state of their configuration better.
• Improved Validation for PAT Tokens: The validation process for TfsEndpoint PAT tokens is enhanced, ensuring that users receive accurate feedback regarding their authentication tokens.

Bug Fixes, 🐛

• Type Registration Fix: The type registration for TfsWorkItemMigrationProcessorOptions in ServiceCollectionExtensions.cs is corrected, resolving issues that could lead to improper validation.
• Configuration Validation Exception Fixes: Several bugs related to the ConfigurationValidationException are addressed, including property name corrections and constructor overloads to improve usability.

Performance Improvements, ⚡️

• Refactoring for Clarity: The validation logic is moved to a separate validator class in TfsWorkItemMigrationProcessorOptions, which streamlines the code and enhances maintainability.

Refactoring, ♻️

• Code Structure Enhancements: Various classes, including ProcessorOptions and TfsWorkItemMigrationProcessorOptions, undergo refactoring to integrate validation logic more effectively and remove redundant components. This restructuring improves code clarity and maintainability.

Documentation Updates, 📝

• Updated Documentation: The MigrationTools.xml file is updated to reflect the latest changes in the codebase, including new branch and commit details. Additionally, error messages in TfsTeamProjectAuthentication.cs and TfsEndpointOptions.cs are revised to include links to relevant documentation, enhancing user guidance.

Dependency Updates, 📌

• Endpoint Type Updates: The configuration.json file is updated to reflect changes in endpoint types, specifically changing EndpointType to AzureDevOpsEndpoint and TfsTeamProjectEndpoint. This ensures that the configuration aligns with the latest service offerings.

Conclusion

The changes in this release significantly enhance the Azure DevOps Migration Tools by improving validation processes, enhancing logging, and updating documentation. These updates not only resolve existing issues but also provide a clearer and more user-friendly experience. As a result, users can expect a more reliable and efficient tool that aligns with their migration needs, ultimately supporting the broader business goals of improving project management and collaboration within Azure DevOps.

For further details, please refer to the relevant Pull Requests.

Get the tools

• Download the MigrationTools-16.0.4-Preview.2.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.2 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.4-preview0002. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• add warning log when node structure enricher is disabled by @MrHinsh in #2370

Full Changelog: v16.0.4-Preview.1...v16.0.4-Preview.2

v16.0.4-Preview.1 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.1

Version: 16.0.4-Preview.1
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces significant improvements in validation processes, enhances error messaging, and refines the overall code structure. These changes aim to improve user experience, ensure better functionality, and maintain high standards of code quality.

Detailed Changes

New Features, ✨

• ConfigurationValidationException: A new exception class is added to handle invalid endpoint types in TfsProcessor.cs. This enhancement allows for clearer error handling when users provide incorrect configurations.
  • Impact: This feature improves the robustness of the application by ensuring that users receive immediate feedback on configuration errors.

Enhancements, 💡

• Validation Logic: The validation logic for NetworkCredentialsOptions, TfsAuthenticationOptions, TfsEndpointOptions, and TfsWorkItemMigrationProcessorOptions is enhanced to implement IValidateOptions. This change ensures that validation is more consistent and reliable across different options.

  • Impact: By standardising validation, the application reduces the likelihood of user errors and improves overall reliability.

• Error Messaging: Error messages in TfsTeamProjectAuthentication.cs and TfsEndpointOptions.cs are updated to include links to documentation. This change helps users quickly find solutions to their issues.

  • Impact: Enhanced error messaging improves user support and reduces the time spent troubleshooting.

Bug Fixes, 🐛

• Type Registration Fix: An incorrect type registration for TfsWorkItemMigrationProcessorOptions is fixed in ServiceCollectionExtensions.cs. This resolves issues that could lead to improper validation.

  • Impact: Fixing this bug ensures that the application functions as intended, preventing potential misconfigurations.

• Configuration Validation Exception: The property name in ConfigurationValidationException is corrected, and a constructor overload is added. Additionally, the processor now throws this exception for missing endpoints.

  • Impact: These fixes enhance the clarity and functionality of error handling, leading to a smoother user experience.

Performance Improvements, ⚡️

• Refactoring for Clarity: The code structure is improved by moving validation logic to a separate validator class and integrating it into the ProcessorOptions class. This refactoring reduces redundancy and enhances maintainability.
  • Impact: Cleaner code leads to better performance and easier future updates.

Refactoring, ♻️

• Code Structure Enhancements: Several classes, including TfsWorkItemMigrationProcessorOptions and Processor.cs, undergo refactoring to improve clarity and reduce redundancy. This includes removing unnecessary calls and integrating validation logic more effectively.
  • Impact: Refactoring contributes to a more maintainable codebase, facilitating future development and reducing technical debt.

Documentation Updates, 📝

• MigrationTools.xml Updates: The documentation is updated to reflect new branch and commit details, ensuring that users have the most current information.
  • Impact: Keeping documentation up to date is crucial for user support and helps maintain the integrity of the project.

Dependency Updates, 📌

• Endpoint Type Updates: The configuration.json file is updated to reflect changes in endpoint types, specifically changing EndpointType to TfsTeamProjectEndpoint and AzureDevOpsEndpoint.
  • Impact: These updates ensure compatibility with the latest Azure DevOps features and improve the overall functionality of the migration tools.

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools by improving validation processes, refining error messaging, and optimising code structure. These updates not only enhance user experience but also align with our commitment to delivering high-quality software. As a result, we expect to see increased user satisfaction and reduced support requests, ultimately contributing to our business goals of reliability and user-centric development.

For further details, please refer to the relevant Pull Requests.

Get the tools

• Download the MigrationTools-16.0.4-Preview.1.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.1 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.4-preview0001. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Improve validation for TfsEndpoint PAT tokens and message by @MrHinsh in #2368

Full Changelog: v16.0.3-Preview.3...v16.0.4-Preview.1

v16.0.3 (Release)

Azure DevOps Migration Tools v16.0.3

Version: 16.0.3
Ring: (Release)

Release Summary for Azure DevOps Migration Tools

Overview

This release introduces several enhancements, bug fixes, and documentation updates aimed at improving user experience and system clarity. The changes reflect our commitment to providing a robust and user-friendly tool for Azure DevOps migration.

Detailed Changes

New Features, ✨

• Add Name Property to IEndpointOptions Interface
  This addition enhances the IEndpointOptions interface by including a Name property, allowing for better identification and management of endpoint options. This change is crucial for users who require more descriptive configurations.
  Related PR: #2361

Enhancements, 💡

• Update How-To Documentation for Pland and Suits to v16
  The documentation is updated to reflect the latest version, ensuring users have access to the most current information and guidance. This is essential for maintaining clarity and usability as the tool evolves.
• Add Defaults for AzureDevOpsEndpoint
  Default settings are introduced for the AzureDevOpsEndpoint, simplifying the setup process for users and reducing configuration errors.
  Related PR: #2355

Bug Fixes, 🐛

• Fixing "Missing" for Reddit User
  This fix addresses a specific issue reported by a user, ensuring that the tool functions correctly in all scenarios.
• Update Validator Errors for Clarity
  Validator error messages are updated to clearly indicate user errors, improving the user experience by providing more informative feedback.
  Related PR: #2363

Documentation Updates, 📝

• Update MigrationTools.xml with New Branch and Commit Details
  The MigrationTools.xml file is updated to include the latest branch and commit information, ensuring that users have accurate and up-to-date references.
• Enhance Permissions Documentation for Clarity and Consistency
  Documentation related to permissions setup is revised for better clarity, helping users navigate permissions more effectively.
• Update Links to Installation and Permissions Documentation
  Links in the getting started documentation are updated to ensure users can easily find the necessary resources for installation and permissions.

Other, 🧱

• Niggles v16 (Docs) + Bugs
  This entry captures various minor updates and bug fixes that contribute to the overall stability and usability of the tool.
  Related PR: #2358

Conclusion

The changes in this release significantly enhance the functionality and usability of the Azure DevOps Migration Tools. By addressing user feedback, improving documentation, and introducing new features, we aim to provide a more seamless experience for our users. These updates not only resolve existing issues but also lay the groundwork for future enhancements, aligning with our business goals of continuous improvement and user satisfaction.

Get the tools

• Download the MigrationTools-16.0.3.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools --version 16.0.3 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.3. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Add defaults for AzureDevOpsEndpoint and rebuild docs. by @MrHinsh in #2355
• Niggles v16 (Docs) + Bugs by @MrHinsh in #2358

Full Changelog: v16.0.2...v16.0.3

v16.0.3-Preview.3 (Preview)

Azure DevOps Migration Tools v16.0.3-Preview.3

Version: 16.0.3-Preview.3
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This release introduces several enhancements, bug fixes, and documentation updates aimed at improving user experience and system clarity. The changes reflect our commitment to providing a robust and user-friendly tool for Azure DevOps migration.

Detailed Changes

New Features, ✨

• Add Name Property to IEndpointOptions Interface
  This addition enhances the IEndpointOptions interface by including a Name property, allowing for better identification and management of endpoint options. This change is crucial for users who require more descriptive configurations.
  Related PR: #2361

Enhancements, 💡

• Update How-To Documentation for Pland and Suits to v16
  The documentation is updated to reflect the latest version, ensuring users have access to the most current information and guidance. This is essential for maintaining clarity and usability as the tool evolves.
• Add Defaults for AzureDevOpsEndpoint
  Default settings are introduced for the AzureDevOpsEndpoint, simplifying the setup process for users and reducing the likelihood of configuration errors.
  Related PR: #2355

Bug Fixes, 🐛

• Fix for "Missing" Issue
  A bug related to the "missing" functionality is resolved, enhancing the reliability of the tool. This fix addresses user-reported issues, thereby improving overall user satisfaction.
• Update Validator Errors for Clarity
  Validator error messages are updated to clearly indicate user errors, reducing confusion and helping users to quickly identify and rectify issues. This change is particularly beneficial for new users who may struggle with error messages.
  Related PR: #2363

Documentation Updates, 📝

• Comprehensive Updates to Permissions Documentation
  The permissions documentation is revised for clarity and consistency, ensuring that users have a clear understanding of the permissions setup process. This is vital for users to effectively manage their access and security settings.
• Update Links in Getting Started Documentation
  Links to installation and permissions documentation are updated, ensuring users can easily navigate to the necessary resources. This enhances the onboarding experience for new users.

Refactoring, ♻️

• Set Endpoint Name During Options Instance Creation
  The code is refactored to set the endpoint name during the creation of options instances, improving code structure and maintainability without altering existing functionality. This change contributes to a cleaner codebase, making future updates easier to implement.

Other, 🧱

• Merge Branches for Documentation and Bug Fixes
  The main branch is merged into the topic branch for niggles v16 documentation and bug fixes, ensuring that all changes are integrated and up-to-date.

Conclusion

The changes in this release significantly enhance the functionality, usability, and clarity of the Azure DevOps Migration Tools. By addressing user feedback and improving documentation, we aim to provide a more intuitive experience for our users. These updates not only resolve existing issues but also lay the groundwork for future enhancements, aligning with our business goals of continuous improvement and user satisfaction.

Get the tools

• Download the MigrationTools-16.0.3-Preview.3.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.3-Preview.3 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.3-preview0003. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Update validator errors to be more clear that is is a user error. by @MrHinsh in #2363

Full Changelog: v16.0.3-Preview.2...v16.0.3-Preview.3

v16.0.3-Preview.2 (Preview)

Azure DevOps Migration Tools v16.0.3-Preview.2

Version: 16.0.3-Preview.2
Ring: (Preview)

Release Summary for Version 16

Overview

The latest release of the Azure DevOps Migration Tools, version 16, introduces several enhancements, bug fixes, and documentation updates aimed at improving user experience and system functionality. This release addresses critical issues while also refining existing features, ensuring that users have access to the most reliable and efficient tools for their migration needs.

Detailed Changes

New Features, ✨

• Addition of Name Property to IEndpointOptions Interface
  This new property allows users to specify a name for the endpoint options, enhancing clarity and usability in configuration settings. This feature is essential for users managing multiple endpoints, as it simplifies identification and management.

Enhancements, 💡

• Setting Endpoint Name During Options Instance Creation
  The EndpointRegistrationExtensions now includes functionality to set the endpoint name when creating an options instance. This improvement streamlines the setup process, making it more intuitive for users.

Bug Fixes, 🐛

• Fix for Issue #2361
  This fix resolves a specific bug that affected the functionality of the migration tools, ensuring a smoother user experience and reducing potential disruptions during migration processes.

Documentation Updates, 📝

• Comprehensive Updates to Documentation
  • MigrationTools.xml: Updated with new branch and commit details to reflect the latest changes accurately.
  • Permissions Documentation: Enhanced clarity and consistency in the permissions.md file, making it easier for users to understand permissions setup.
  • Installation and Permissions Links: Updated links in the docs/getstarted/index.md to direct users to the most current installation and permissions documentation.

Other, 🧱

• Defaults for AzureDevOpsEndpoint
  The addition of default settings for the AzureDevOpsEndpoint simplifies the initial configuration process for users, allowing for quicker setup and deployment.

Conclusion

The changes introduced in this release significantly enhance the functionality and usability of the Azure DevOps Migration Tools. By addressing bugs, adding new features, and improving documentation, this version aims to provide a more robust and user-friendly experience. These updates not only improve operational efficiency but also align with our commitment to delivering high-quality tools that meet the evolving needs of our users. As we move forward, we anticipate that these enhancements will contribute positively to user satisfaction and project success.

For further details, please refer to the relevant Pull Requests.

Get the tools

• Download the MigrationTools-16.0.3-Preview.2.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.3-Preview.2 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.3-preview0002. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Niggles v16 (Docs) + Bugs by @MrHinsh in #2358

Full Changelog: v16.0.3-Preview.1...v16.0.3-Preview.2

v16.0.3-Preview.1 (Preview)

Azure DevOps Migration Tools v16.0.3-Preview.1

Version: 16.0.3-Preview.1
Ring: (Preview)

Overview

This release introduces several enhancements and updates to the Azure DevOps Migration Tools, focusing on improving user experience and documentation clarity. The changes aim to streamline the configuration process and ensure that users have access to the most relevant information.

Detailed Changes

New Features, ✨

• Defaults for AzureDevOpsEndpoint: The addition of default settings for the AzureDevOpsEndpoint simplifies the setup process for users, allowing for quicker configuration and reducing the potential for errors. This feature is particularly beneficial for new users who may find the initial setup daunting.
  • Pull Request: #2355

Enhancements, 💡

• Updated Defaults: The update to the default settings enhances the overall user experience by providing more intuitive configurations. This change ensures that users can start using the tool with minimal adjustments, thereby increasing productivity and satisfaction.

Documentation Updates, 📝

• Rebuild Documentation: The documentation has been rebuilt to reflect the new defaults and provide clearer guidance on the configuration process. This update is crucial for ensuring that users have access to accurate and comprehensive information, which can lead to better utilisation of the tool.

Conclusion

The changes made in this release significantly enhance the usability of the Azure DevOps Migration Tools. By introducing new defaults and improving documentation, the team addresses common user challenges, ultimately supporting the project's goal of providing a seamless migration experience. These updates are expected to lead to increased user adoption and satisfaction, aligning with our broader business objectives of enhancing product quality and user engagement.

Get the tools

• Download the MigrationTools-16.0.3-Preview.1.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.3-Preview.1 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.3-preview0001. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Add defaults for AzureDevOpsEndpoint and rebuild docs. by @MrHinsh in #2355

Full Changelog: v16.0.2...v16.0.3-Preview.1

v16.0.2 (Release)

Azure DevOps Migration Tools v16.0.2

Version: 16.0.2
Ring: (Release)

Release Summary for Azure DevOps Migration Tools

Overview

This release introduces significant enhancements and fixes to the Azure DevOps Migration Tools, focusing on improving processor metrics, validation processes, and overall functionality. The changes aim to enhance user experience, streamline operations, and address critical issues identified in previous versions.

Detailed Changes

New Features, ✨

• Processor Metrics:
  • Description: The addition of processor metrics provides users with valuable insights into processor performance and usage.
  • Impact: This feature enables better monitoring and optimisation of resources, which can lead to improved efficiency in operations.
  • Pull Requests: #2352, #2350

Enhancements, 💡

• Custom Mapping for TfsNodeStructureTool:
  • Description: Custom mappings for new formats in the TfsNodeStructureTool have been implemented.
  • Impact: This enhancement allows for better compatibility with various data formats, improving the tool's versatility and user satisfaction.
  • Pull Requests: #2350

Bug Fixes, 🐛

• ProcessDefinitionProcessor Fix:

  • Description: Resolved an issue where the ProcessDefinitionProcessor failed due to an uninitialised configuration.
  • Impact: This fix ensures that the processor operates correctly, preventing disruptions in workflow.
  • Pull Requests: #2351

• Validation Updates:

  • Description: Various validation issues have been addressed, including those related to endpoint validation and node structure language mappings.
  • Impact: These fixes enhance the reliability of the tool, ensuring that users receive accurate feedback and error messages.
  • Pull Requests: #2343

Performance Improvements, ⚡️

• Processor Validator Activation:
  • Description: The processor validator has been activated to enhance the validation process.
  • Impact: This improvement increases the robustness of the validation checks, leading to fewer errors and a smoother user experience.

Refactoring, ♻️

• Code Structure Improvements:
  • Description: Several code refactoring efforts have been made, including renaming tests for clarity and removing unnecessary solution files.
  • Impact: These changes improve code maintainability and readability, facilitating easier future updates and collaboration among developers.

Documentation Updates, 📝

• Documentation Enhancements:
  • Description: Updates to the documentation have been made to reflect the latest changes and improvements.
  • Impact: Improved documentation aids users in understanding new features and functionalities, enhancing overall user experience.
  • Pull Requests: #2343

Dependency Updates, 📌

• Library and Tool Updates:
  • Description: Various dependencies have been updated to their latest versions.
  • Impact: Keeping dependencies up to date ensures better security, performance, and compatibility with other tools.

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools, addressing critical issues while adding valuable new features. These improvements are expected to lead to increased user satisfaction, better performance, and a more robust toolset for managing Azure DevOps migrations. The team remains committed to continuous improvement and looks forward to further enhancing the user experience in future releases.

Get the tools

• Download the MigrationTools-16.0.2.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools --version 16.0.2 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.2. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Topic/niggles v16 2 by @MrHinsh in #2339
• v16 Niggles (3) by @MrHinsh in #2342
• v16 Niggles - #4! Validation by @MrHinsh in #2343
• Added custom mapping for new format in TfsNodeStructureTool by @MrHinsh in #2350
• Fix for ProcessDefinitionProcessor failing on "You must call Configure() first" by @MrHinsh in #2351
• Add Processor Metrics by @MrHinsh in #2352

Full Changelog: v16.0.1...v16.0.2

v16.0.2-Preview.5 (Preview)

Azure DevOps Migration Tools v16.0.2-Preview.5

Version: 16.0.2-Preview.5
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This release introduces significant enhancements and fixes to the Azure DevOps Migration Tools, focusing on improving processor metrics, validation processes, and overall functionality. The changes aim to enhance user experience, streamline operations, and address critical issues identified in previous versions.

Detailed Changes

New Features, ✨

• Processor Metrics:
  • Description: The addition of processor metrics provides users with valuable insights into processor performance and usage.
  • Impact: This feature enables better monitoring and optimisation of resources, leading to improved efficiency in operations.
  • Pull Requests: #2352, #2350

Enhancements, 💡

• Custom Mapping for TfsNodeStructureTool:
  • Description: Custom mappings for new formats in the TfsNodeStructureTool have been implemented.
  • Impact: This enhancement allows for better compatibility with various data formats, improving the tool's versatility and user satisfaction.
  • Pull Requests: #2350

Bug Fixes, 🐛

• ProcessDefinitionProcessor Fix:

  • Description: Resolved an issue where the ProcessDefinitionProcessor failed due to an uninitialised configuration.
  • Impact: This fix ensures that the processor operates correctly, preventing disruptions in workflow.
  • Pull Requests: #2351

• Validation Updates:

  • Description: Various validation issues have been addressed, including those related to endpoint validation and node structure language mappings.
  • Impact: These fixes enhance the reliability of the tool, ensuring that users receive accurate feedback and error messages.
  • Pull Requests: #2343

Performance Improvements, ⚡️

• Processor Validator Activation:
  • Description: The processor validator has been activated to enhance the validation process.
  • Impact: This improvement leads to more robust validation checks, ensuring that data integrity is maintained throughout the migration process.

Refactoring, ♻️

• Code Structure Improvements:
  • Description: Several code refactoring efforts have been made to improve clarity and maintainability.
  • Impact: These changes facilitate easier future updates and enhancements, contributing to the long-term sustainability of the codebase.

Documentation Updates, 📝

• Documentation Enhancements:
  • Description: Updates to the documentation have been made to reflect the latest changes and improvements.
  • Impact: Improved documentation aids users in understanding new features and functionalities, enhancing overall user experience.
  • Pull Requests: #2343

Dependency Updates, 📌

• Library and Package Updates:
  • Description: Various dependencies have been updated to their latest versions.
  • Impact: Keeping dependencies up to date ensures better security, performance, and compatibility with other tools.

Conclusion

The changes introduced in this release significantly enhance the functionality and reliability of the Azure DevOps Migration Tools. By addressing critical bugs, adding new features, and improving existing functionalities, this update positions the tool for better performance and user satisfaction. The ongoing commitment to refining the tool aligns with our business goals of providing a robust and efficient solution for Azure DevOps migrations.

Get the tools

• Download the MigrationTools-16.0.2-Preview.5.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.2-Preview.5 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.2-preview0005. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Add Processor Metrics by @MrHinsh in #2352

Full Changelog: v16.0.2-Preview.4...v16.0.2-Preview.5

v16.0.2-Preview.4 (Preview)

Azure DevOps Migration Tools v16.0.2-Preview.4

Version: 16.0.2-Preview.4
Ring: (Preview)

Release Summary

This release introduces several important updates to the Azure DevOps Migration Tools, focusing on bug fixes, enhancements, and new features. The changes aim to improve the overall functionality and user experience of the tool, ensuring it meets the evolving needs of our users.

Detailed Changes

New Features, ✨

• Custom Mapping for New Format in TfsNodeStructureTool
  Added custom mapping capabilities to support a new format in the TfsNodeStructureTool. This enhancement allows users to work with updated data structures more effectively.
  PR #2350

Enhancements, 💡

• Validation Updates
  Improved validation processes across various components, including the addition of a validator for TfsNodeStructureTool and endpoint validations. These enhancements ensure that data integrity is maintained and errors are caught early in the process.
  PR #2343
  PR #2342

Bug Fixes, 🐛

• Fix for ProcessDefinitionProcessor
  Resolved an issue where the ProcessDefinitionProcessor failed with the message "You must call Configure() first." This fix ensures that the processor operates correctly without interruptions.
  PR #2351
• Addressed Validation Errors
  Fixed multiple validation errors, including issues related to incorrect formats and unhandled exceptions in the TfsNodeStructureTool. These fixes enhance the reliability of the tool.
  PR #2339

Performance Improvements, ⚡️

• Processor Validator Activation
  The processor validator is now activated, which improves the efficiency of data processing by ensuring that only valid data is processed. This change is expected to enhance performance and reduce errors during migration tasks.

Refactoring, ♻️

• Code Structure Improvements
  Various updates have been made to improve code clarity and maintainability, including renaming tests for better understanding and removing unnecessary solution files. These changes do not alter functionality but enhance the overall codebase quality.

Documentation Updates, 📝

• Updated Documentation
  Documentation has been revised to reflect the latest changes and improvements, ensuring that users have access to accurate and up-to-date information regarding the tool's functionalities.
  PR #2342

Dependency Updates, 📌

• General Updates
  Various updates to dependencies have been made to ensure compatibility and leverage improvements from third-party libraries.

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools, addressing critical bugs, improving performance, and adding valuable new features. These updates not only improve the user experience but also align with our commitment to delivering a robust and reliable tool for our users. As we continue to evolve, these enhancements position us well to meet future challenges and user needs effectively.

Get the tools

• Download the MigrationTools-16.0.2-Preview.4.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.2-Preview.4 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
• Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.2-preview0004. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

• Fix for ProcessDefinitionProcessor failing on "You must call Configure() first" by @MrHinsh in #2351

Full Changelog: v16.0.2-Preview.3...v16.0.2-Preview.4