Skip to content

v16.0.4-Preview.1 (Preview)

Pre-release
Pre-release
Compare
Choose a tag to compare
@nkdagility-actions-bot nkdagility-actions-bot released this 15 Sep 23:40
· 198 commits to main since this release
v16.0.4-Preview.1
c1dc8d1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.

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

Contributors

MrHinsh
Assets 5
Loading