diff --git a/README.md b/README.md index cd3bf61b7..a9cb7e734 100644 --- a/README.md +++ b/README.md @@ -126,39 +126,17 @@ We use these tools with our customers, and for fun, to do real world migrations ## Change Log -- [v15.0.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.0.0) - Release v15! Query and CommonEnrichersConfig changes -- [v14.4.6](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.6) - Release v14! Migrate to winget and change exe name to `devopsmigration` -- [v13.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - Oct 9, 2023 - - 13.2 - Added [ExportUsersForMapping](https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v1/Processors/TeamMigrationContext/) to export a json file with a list of users ready for a field mapping. - - 13.1 - Update all NuGet packages to the latest version. - - 13.0 - Update to .net 7.0 with all dependencies. Focus on documentation improvements to support future updates. -- [v12.8.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - Apr 25, 2023 - - 12.1 - Make embedded images regex lazy - - 12.1 - Added a stop when there are area or iteration nodes in the source history that are not in the target. This causes missing data. System will now list the areas and iteration that are missing, and then stop. You can decide to add them manually, or add a field mapping. -- [v11.12.23](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.12.23) - Jun 6, 2022 - - v11.11 - Refactored revision manager to have more tests and support limiting the number of revisions. CollapseRevisions has been replaced by setting MaxRevisions to 1 and setting AttachRevisionHistory to true; MaxRevisions sets the maximum number of revisions that will be migrated. "First + Last*N = Max". If this was set to 5 and there were 10 revisions you would get the first 1 (creation) and the latest 4 migrated. This is done after all of the existing revisions are created but before anything newer than that target is removed. - - v11.10 - Added ability to limit the number of revisions migrated with `MaxRevisions` on the `WorkItemMigration` processor. 0 = All, and any other number should migrate the first revision + the latest up to MAX. - - v11.9 - Dark launch of `Process` migration by @akanieski - - v11.9 - Dark launch of `Pipelines` & `Builds` migration by @tomfrenzel - - v11.8 - As part of moving to the new architecture we moved to default newtonsoft type handling with `$type` properties instead of `ObjectType` ___To Migrate rename "ObjectType" to "$type" in your configuration!___ - - v11.5 - Added more useful logging levels. Replace `"TelemetryEnableTrace": false` with `"LogLevel": "Verbose"` in the config. Verbose will only be logged to the logfile. - - v11.2.1 - Removed NodeMigrationContext and converted it to an enricher for Work Items. Still needs work, so that it migrates individual nodes, but currently migrates all. -- [v10.2.13](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - Sep 27, 2020 - - v10.1 - Changed config design to have only the Name and not FullName of the class. Remove `MigrationTools.Core.Configuration.FieldMap.` and `MigrationTools.Core.Configuration.Processing.` from the config leaving only the Name of the class in the ObjectType field. - - v10.0 - Start of the great refactor over to .NET Core and the REST API as the Object Model has been retired. -- [v9.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - Sep 7, 2020 -- v9.0 - Added support for migration between other language versions of Azure DevOps. Developed for German -> English -- [v8.9.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) -Aug 6, 2020 - - v8.9 - Added 'Collapse Revisions' feature to collapse and attache revisions instead of replaying them - - v8.8 - 'SkipToFinalRevisedWorkItemType' feature added to handle scenario when changing Work Item Type - - v8.7 - Support for inline images using a Personal Access Token added to the Source Project - - v8.6 - Support for fixing links from TFVC Changesets to Git Commits using a mapping file generated from a Git-TFS migration. - - v8.5 - Attachment Max size and linking work items to git repos between projects. - - v8.4 - Support for cross-project linking of work items between projects. - - v8.3 - Support for restarting the migration and syncing at the revision level. - - v8.2 - Merge Git commit Fixing into Work Item migration (requires repos to be migrated first, can be rerun) - - v8.0 - Merge of Work Item, Link, & attachment migrators into one. -- [v7.5.74](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) Sep 18, 2019 -- [v6.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) Feb 23, 2017 - -- +- [v15.1.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.1.7) - The latest release brings a host of enhancements and fixes designed to improve user experience and configuration options. Noteworthy features include a new GitHub Actions workflow for automatic updates to pull request titles, enhanced management of area and iteration paths using regex mapping, and a more streamlined query format for migration configurations. Users can now enjoy greater flexibility in configuring attachment processing, including options for export paths and size limits. Additionally, updates to authentication methods and improved logging for user retrieval processes have been implemented. The release also addresses various bugs and makes adjustments to enhance overall functionality. +- [v14.4.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - The latest major release brings a host of user-focused enhancements and improvements. Key changes include the adoption of Winget as the primary installation method, making it easier for users to get started. The main executable has been renamed to `devopsmigration.exe`, and new configuration options enhance customization capabilities, including parallel builds and test case timeouts. The command for initializing configurations has been updated for greater flexibility, and logging improvements provide better insights during migration operations. Subsequent updates have refined version detection, improved command line arguments, and introduced new configuration files to prevent blank issues. Enhanced logging and error handling further improve user experience, while package upgrades and better handling of specific fields streamline migration processes. Overall, these updates aim to enhance functionality, usability, and reliability for users. +- [v13.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - The latest updates bring a range of enhancements and new features aimed at improving user experience and functionality. A key addition is the `WorkItemMigrationContext` processor, which facilitates the migration of work items, including their history and attachments, between Azure DevOps instances. Users will find clearer documentation and a new configuration file to simplify work item type and field mappings. The introduction of the `ExportUsersForMapping` feature allows for easy JSON file exports for field mapping, while security is bolstered with an updated authentication mode. Users can now disable telemetry collection during migration, and various improvements have been made to migration behavior and configuration settings, enhancing the overall robustness and integrity of the migration tools. +- [v12.8.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - The latest major release brings a host of enhancements designed to improve user experience and streamline migration processes. New configuration options for migration processors offer greater flexibility, allowing users to define custom remapping rules for area and iteration paths. Significant improvements in field mapping configurations and enhanced documentation provide clearer guidance for users. The introduction of features like case-insensitive matching for regular expressions and new parameters for work item migration enhances functionality. Additionally, updates to logging, error handling, and overall documentation structure ensure a more robust and user-friendly experience. Various bug fixes further contribute to the reliability and clarity of the migration tools, making the overall process smoother for users. +- [v11.9.55](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - The latest major release introduces a variety of impactful changes designed to enhance user experience and streamline migration processes. Key features include a rebranding of the project to "MigrationTools," improved configuration options, and enhanced error handling for migration operations. Users can now limit revisions during work item migrations, customize field retrieval, and benefit from new logging capabilities for better traceability. The introduction of new interfaces and methods, along with refined documentation, supports improved work item management and configuration flexibility. Overall, these updates aim to provide a more efficient, user-friendly migration experience while addressing previous bugs and enhancing system performance. +- [v10.2.13](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - The latest updates to the Migration Tools suite introduce a range of impactful enhancements for users. New projects, such as "MigrationTools.Sinks.AzureDevOps," have been added, along with a revamped console UI for improved Azure DevOps integration. Configuration management has been enhanced, allowing for easier JSON file loading and new telemetry settings. The migration engine has been optimized for better work item handling, and logging has been clarified. Users will need to update their configuration files due to a namespace change and new parameters for work item migration. Subsequent updates further simplify the configuration process, improve field mapping options, and enhance documentation for migrating test artifacts. Overall, these changes provide users with greater flexibility, control, and usability in their migration tasks. +- [v9.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - The latest major release brings a host of user-focused enhancements and improvements. Key features include multi-language support for Azure DevOps migrations, allowing for greater flexibility in handling different language versions. Users will benefit from improved configuration documentation, which now includes new fields for language mapping of Area and Iteration paths. Subsequent updates have introduced customizable field mappings, conditional logic for excluding specific work item types, and enhanced error handling for better troubleshooting. Additionally, logging capabilities have been significantly upgraded, providing more structured output and insights into application performance. Overall, these changes aim to streamline the migration process and improve user experience. +- [v8.9.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - The latest major release introduces a range of impactful enhancements and features designed to improve user experience and streamline migration processes. Users can now take advantage of enhanced configuration options, including custom paths for configuration files and new modes for the `init` command. The migration process has been significantly refined with improved error handling, better logging, and new parameters for managing attachments and links. Notable features include the ability to sync changes post-migration, retry failed work item saves, and customize attachment handling. Additionally, the rebranding of the tool ensures users have access to accurate documentation and resources. Overall, these updates focus on providing greater control, efficiency, and clarity throughout the migration experience. +- [7.5.74](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - The latest major release brings a host of user-focused enhancements and features designed to improve performance and usability. Key updates include a framework upgrade that boosts application performance and compatibility, alongside dependency updates for improved functionality and security. New configuration options allow for greater flexibility during data migration, including filtering elements by tags and replaying work item revisions. Enhancements to error handling and logging, as well as improvements in attachment management, contribute to a more reliable user experience. Additionally, the introduction of online status checks for version updates ensures users stay informed about the latest changes while connected to the internet. +- [6.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - The latest major release brings a host of impactful changes for users. A key highlight is the rebranding of the command-line tool to `vstssyncmigrator`, accompanied by updated documentation to assist with the new command structure. Enhancements to attachment export and import migration contexts improve ID formatting, while the restructuring of project organization may necessitate updates to project references. Users will also benefit from improved global configuration documentation, with various processors now enabled by default for immediate functionality. New features include the `WorkItemQueryMigrationContext`, allowing for selective migration of work item queries, and the option to prefix project names in folder paths for better organization. Enhanced logging and an updated FAQ section further support users in managing their migration processes effectively. +- [5.3.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - The latest major release brings a host of impactful changes designed to enhance user experience and functionality. Key updates include a rebranding to "VSTS Sync Migration Tools" and a simplified command name for installation and uninstallation. Users can now benefit from the new `MultiValueConditionalMapConfig` class, which allows for more complex field mapping configurations. Version 5.1 introduces customizable user preferences and improved command-line functionality, while 5.3 enhances the migration process for test plans with a new method for handling test cases, updates to installation scripts for better package verification, and optimizations in field merging. Comprehensive new documentation supports these changes, ensuring users can easily adapt to the updated features and configurations. +- [4.4.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - The latest major release introduces a range of impactful enhancements aimed at improving user experience and flexibility during work item migration. A key feature is the new configuration option, `PrefixProjectToNodes`, which allows users to customize the prefixing of project names to area and iteration paths, as well as nodes, enhancing project structure management. The migration logic has been updated to support these options, streamlining the migration process. Additionally, users will benefit from improved documentation, including clearer installation instructions and new JSON configuration files. The release also includes an uninstall script for easier tool management and enhancements to caching and field exclusion during migrations, further refining the overall functionality. +- [3.6.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - The latest updates bring a host of enhancements designed to improve user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for tailored migration processes, and the introduction of classes for managing team settings. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The migration process has been streamlined with improved telemetry tracking and error handling, while new documentation provides valuable context and guidance. Significant improvements to the TfsWitMigrator tool enhance work item tagging flexibility, and updates to the migration context for test plans and variables offer greater control during migrations. Overall, these changes aim to make data migration more efficient and user-friendly. +- [0.5.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - The latest update brings a range of enhancements designed to improve user experience. Users will benefit from increased performance and stability, alongside new features that simplify interactions. Additionally, numerous bugs identified in earlier releases have been resolved, contributing to a more seamless and dependable operation. This update focuses on creating a more efficient and user-friendly environment for all. diff --git a/build/include/ReleaseMan.ps1 b/build/include/ReleaseMan.ps1 index 620223cff..f30dbacee 100644 --- a/build/include/ReleaseMan.ps1 +++ b/build/include/ReleaseMan.ps1 @@ -428,6 +428,9 @@ function Get-ChangeLogMarkdown { "" ) + # Reverse the order of the grouped major releases + $groupedReleases = $groupedReleases | Sort-Object -Property Major -Descending + # Iterate through each major release foreach ($majorRelease in $groupedReleases) { $majorReleaseMajor = $majorRelease.Major @@ -438,14 +441,17 @@ function Get-ChangeLogMarkdown { $majorLine = "- [v$majorReleaseMajor.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/$majorReleaseLatestTagName) - $majorReleaseSummary" $markdownLines += $majorLine + # Reverse the order of the grouped major releases + $minorReleases = $majorRelease.Releases | Sort-Object -Property MinorVersion -Descending + # Iterate through the minor releases under this major release - foreach ($minorRelease in $majorRelease.Releases) { + foreach ($minorRelease in $minorReleases) { $minorLatestTagName = $minorRelease.LatestTagName $minorSummary = $minorRelease.Summary $minorReleaseMinor = $minorRelease.Minor # Generate the minor release markdown - $minorLine = " - [v$minorReleaseMinor](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/$minorLatestTagName) - $minorSummary" + $minorLine = " - [$minorLatestTagName](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/$minorLatestTagName) - $minorSummary" $markdownLines += $minorLine } } @@ -458,3 +464,37 @@ function Get-ChangeLogMarkdown { Write-Host "Change log markdown has been generated and saved to $outputFilePath" } + +function Get-ChangeLogLightMarkdown { + param ( + [string]$inputFilePath = "./docs/_data/releases-grouped-major.json", + [string]$outputFilePath = "./change-log.md" + ) + + $markdownLines = @() + # Load the grouped major releases + $groupedReleases = Get-Content -Raw -Path $inputFilePath | ConvertFrom-Json + + # Reverse the order of the grouped major releases + $groupedReleases = $groupedReleases | Sort-Object -Property Major -Descending + + # Iterate through each major release + foreach ($majorRelease in $groupedReleases) { + $majorReleaseMajor = $majorRelease.Major + $majorReleaseLatestTagName = $majorRelease.LatestTagName + $majorReleaseSummary = $majorRelease.Summary + + # Generate the major release markdown + $majorLine = "- [$majorReleaseLatestTagName](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/$majorReleaseLatestTagName) - $majorReleaseSummary" + $markdownLines += $majorLine + + } + + # Combine the markdown lines into a single string + $markdownContent = $markdownLines -join "`n" + + # Save the markdown content to the output file + Set-Content -Path $outputFilePath -Value $markdownContent + + Write-Host "Change log markdown has been generated and saved to $outputFilePath" +} \ No newline at end of file diff --git a/build/mantainReleaseLog.ps1 b/build/mantainReleaseLog.ps1 index 910305dd3..50dc13bf4 100644 --- a/build/mantainReleaseLog.ps1 +++ b/build/mantainReleaseLog.ps1 @@ -24,5 +24,5 @@ Update-ReleaseGroups-MinorSummaries Update-ReleaseGroups-Major Update-ReleaseGroups-MajorSummaries Get-ChangeLogMarkdown - +Get-ChangeLogLightMarkdown #============================================================================== \ No newline at end of file diff --git a/change-log.md b/change-log.md new file mode 100644 index 000000000..5a5a722ca --- /dev/null +++ b/change-log.md @@ -0,0 +1,14 @@ +- [v15.1.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.1.7) - The latest release brings a host of enhancements and fixes designed to improve user experience and configuration options. Noteworthy features include a new GitHub Actions workflow for automatic updates to pull request titles, enhanced management of area and iteration paths using regex mapping, and a more streamlined query format for migration configurations. Users can now enjoy greater flexibility in configuring attachment processing, including options for export paths and size limits. Additionally, updates to authentication methods and improved logging for user retrieval processes have been implemented. The release also addresses various bugs and makes adjustments to enhance overall functionality. +- [v14.4.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - The latest major release brings a host of user-focused enhancements and improvements. Key changes include the adoption of Winget as the primary installation method, making it easier for users to get started. The main executable has been renamed to `devopsmigration.exe`, and new configuration options enhance customization capabilities, including parallel builds and test case timeouts. The command for initializing configurations has been updated for greater flexibility, and logging improvements provide better insights during migration operations. Subsequent updates have refined version detection, improved command line arguments, and introduced new configuration files to prevent blank issues. Enhanced logging and error handling further improve user experience, while package upgrades and better handling of specific fields streamline migration processes. Overall, these updates aim to enhance functionality, usability, and reliability for users. +- [v13.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - The latest updates bring a range of enhancements and new features aimed at improving user experience and functionality. A key addition is the `WorkItemMigrationContext` processor, which facilitates the migration of work items, including their history and attachments, between Azure DevOps instances. Users will find clearer documentation and a new configuration file to simplify work item type and field mappings. The introduction of the `ExportUsersForMapping` feature allows for easy JSON file exports for field mapping, while security is bolstered with an updated authentication mode. Users can now disable telemetry collection during migration, and various improvements have been made to migration behavior and configuration settings, enhancing the overall robustness and integrity of the migration tools. +- [v12.8.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - The latest major release brings a host of enhancements designed to improve user experience and streamline migration processes. New configuration options for migration processors offer greater flexibility, allowing users to define custom remapping rules for area and iteration paths. Significant improvements in field mapping configurations and enhanced documentation provide clearer guidance for users. The introduction of features like case-insensitive matching for regular expressions and new parameters for work item migration enhances functionality. Additionally, updates to logging, error handling, and overall documentation structure ensure a more robust and user-friendly experience. Various bug fixes further contribute to the reliability and clarity of the migration tools, making the overall process smoother for users. +- [v11.9.55](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - The latest major release introduces a variety of impactful changes designed to enhance user experience and streamline migration processes. Key features include a rebranding of the project to "MigrationTools," improved configuration options, and enhanced error handling for migration operations. Users can now limit revisions during work item migrations, customize field retrieval, and benefit from new logging capabilities for better traceability. The introduction of new interfaces and methods, along with refined documentation, supports improved work item management and configuration flexibility. Overall, these updates aim to provide a more efficient, user-friendly migration experience while addressing previous bugs and enhancing system performance. +- [v10.2.13](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - The latest updates to the Migration Tools suite introduce a range of impactful enhancements for users. New projects, such as "MigrationTools.Sinks.AzureDevOps," have been added, along with a revamped console UI for improved Azure DevOps integration. Configuration management has been enhanced, allowing for easier JSON file loading and new telemetry settings. The migration engine has been optimized for better work item handling, and logging has been clarified. Users will need to update their configuration files due to a namespace change and new parameters for work item migration. Subsequent updates further simplify the configuration process, improve field mapping options, and enhance documentation for migrating test artifacts. Overall, these changes provide users with greater flexibility, control, and usability in their migration tasks. +- [v9.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - The latest major release brings a host of user-focused enhancements and improvements. Key features include multi-language support for Azure DevOps migrations, allowing for greater flexibility in handling different language versions. Users will benefit from improved configuration documentation, which now includes new fields for language mapping of Area and Iteration paths. Subsequent updates have introduced customizable field mappings, conditional logic for excluding specific work item types, and enhanced error handling for better troubleshooting. Additionally, logging capabilities have been significantly upgraded, providing more structured output and insights into application performance. Overall, these changes aim to streamline the migration process and improve user experience. +- [v8.9.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - The latest major release introduces a range of impactful enhancements and features designed to improve user experience and streamline migration processes. Users can now take advantage of enhanced configuration options, including custom paths for configuration files and new modes for the `init` command. The migration process has been significantly refined with improved error handling, better logging, and new parameters for managing attachments and links. Notable features include the ability to sync changes post-migration, retry failed work item saves, and customize attachment handling. Additionally, the rebranding of the tool ensures users have access to accurate documentation and resources. Overall, these updates focus on providing greater control, efficiency, and clarity throughout the migration experience. +- [7.5.74](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - The latest major release brings a host of user-focused enhancements and features designed to improve performance and usability. Key updates include a framework upgrade that boosts application performance and compatibility, alongside dependency updates for improved functionality and security. New configuration options allow for greater flexibility during data migration, including filtering elements by tags and replaying work item revisions. Enhancements to error handling and logging, as well as improvements in attachment management, contribute to a more reliable user experience. Additionally, the introduction of online status checks for version updates ensures users stay informed about the latest changes while connected to the internet. +- [6.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - The latest major release brings a host of impactful changes for users. A key highlight is the rebranding of the command-line tool to `vstssyncmigrator`, accompanied by updated documentation to assist with the new command structure. Enhancements to attachment export and import migration contexts improve ID formatting, while the restructuring of project organization may necessitate updates to project references. Users will also benefit from improved global configuration documentation, with various processors now enabled by default for immediate functionality. New features include the `WorkItemQueryMigrationContext`, allowing for selective migration of work item queries, and the option to prefix project names in folder paths for better organization. Enhanced logging and an updated FAQ section further support users in managing their migration processes effectively. +- [5.3.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - The latest major release brings a host of impactful changes designed to enhance user experience and functionality. Key updates include a rebranding to "VSTS Sync Migration Tools" and a simplified command name for installation and uninstallation. Users can now benefit from the new `MultiValueConditionalMapConfig` class, which allows for more complex field mapping configurations. Version 5.1 introduces customizable user preferences and improved command-line functionality, while 5.3 enhances the migration process for test plans with a new method for handling test cases, updates to installation scripts for better package verification, and optimizations in field merging. Comprehensive new documentation supports these changes, ensuring users can easily adapt to the updated features and configurations. +- [4.4.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - The latest major release introduces a range of impactful enhancements aimed at improving user experience and flexibility during work item migration. A key feature is the new configuration option, `PrefixProjectToNodes`, which allows users to customize the prefixing of project names to area and iteration paths, as well as nodes, enhancing project structure management. The migration logic has been updated to support these options, streamlining the migration process. Additionally, users will benefit from improved documentation, including clearer installation instructions and new JSON configuration files. The release also includes an uninstall script for easier tool management and enhancements to caching and field exclusion during migrations, further refining the overall functionality. +- [3.6.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - The latest updates bring a host of enhancements designed to improve user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for tailored migration processes, and the introduction of classes for managing team settings. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The migration process has been streamlined with improved telemetry tracking and error handling, while new documentation provides valuable context and guidance. Significant improvements to the TfsWitMigrator tool enhance work item tagging flexibility, and updates to the migration context for test plans and variables offer greater control during migrations. Overall, these changes aim to make data migration more efficient and user-friendly. +- [0.5.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - The latest update brings a range of enhancements designed to improve user experience. Users will benefit from increased performance and stability, alongside new features that simplify interactions. Additionally, numerous bugs identified in earlier releases have been resolved, contributing to a more seamless and dependable operation. This update focuses on creating a more efficient and user-friendly environment for all. diff --git a/docs/change-log.md b/docs/change-log.md index 20ca51b6c..59c6cb504 100644 --- a/docs/change-log.md +++ b/docs/change-log.md @@ -11,90 +11,90 @@ redirect_from: /change-log.html ## Change Log -- [v0.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - The latest update brings a range of enhancements designed to improve user experience. Users will benefit from increased performance and stability, alongside new features that simplify interactions. Additionally, numerous bugs identified in earlier releases have been resolved, contributing to a more seamless and dependable operation. This update focuses on creating a more efficient and user-friendly environment for all. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - Version 0.5.1 introduces several user-impacting changes, including new features, improvements, and bug fixes. Users can expect enhanced performance and stability, along with the addition of new functionalities that streamline their experience. This update also addresses various bugs reported in previous versions, ensuring a smoother and more reliable operation. Overall, version 0.5.1 aims to provide a more efficient and user-friendly environment. -- [v3.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - The latest updates bring a host of enhancements designed to improve user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for tailored migration processes, and the introduction of classes for managing team settings. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The migration process has been streamlined with improved telemetry tracking and error handling, while new documentation provides valuable context and guidance. Significant improvements to the TfsWitMigrator tool enhance work item tagging flexibility, and updates to the migration context for test plans and variables offer greater control during migrations. Overall, these changes aim to make data migration more efficient and user-friendly. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.0.0.41) - Version 3.0 introduces several impactful changes aimed at enhancing user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for customized migration processes, and the introduction of classes for team migration, which facilitate team settings management. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The update also streamlines work item saving processes, improves telemetry tracking for better monitoring, and enhances error tracking capabilities. Notably, the assembly versioning scheme has been updated, and various configuration options have been added or improved, providing users with greater control and flexibility in their migration tasks. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.1.0.2) - Version 3.1.0.2 introduces a new configuration option, `AreaIterationPath`, to the `TestPlansAndSuitsMigrationConfig` class, significantly enhancing the flexibility of migration settings for users. Additionally, improvements have been made to trace logging, with the inclusion of a consistent identifier, "vstsbulkeditor," which enhances the clarity of log outputs during execution and migration processes. These updates aim to improve user experience and streamline migration workflows. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.2.3.1) - Version 3.2 introduces several user-impacting changes, including the addition of a new documentation page titled "Why," which provides users with enhanced context and links to further information. Additionally, the VSTS Bulk Data Editor & Migrator has undergone significant improvements, requiring users to create a new `vstsbulkeditor.yml` file for defining migration settings. This update includes comprehensive documentation on configuration options, command-line usage instructions, and a NuGet package for advanced users, alongside enhancements in error handling and the migration process for test plans and suites. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.3.0.4) - Version 3.3 introduces significant user-impacting changes, including the public accessibility of the `Program` class, which broadens user interaction capabilities. Enhancements to the TfsWitMigrator feature a new configuration option for fixing Git commit links, allowing users to specify query conditions for link migrations. The Application Insights configuration has been improved to include performance monitoring modules, and telemetry events now track unhandled exceptions, enhancing error reporting. Additionally, the introduction of unit tests for the `EngineConfiguration` and `MigrationEngine` classes strengthens the testing framework, while new configuration files ensure proper assembly binding and dependencies, particularly for Newtonsoft.Json. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.4.1.1) - Version 3.4 introduces significant user-impacting changes, including the release of version 3.4.1.1, which adds a new configuration option for mapping field values to tags in the TfsWitMigrator tool. This enhancement allows users to define a source field, a matching pattern, and a format expression for tag creation, greatly improving the flexibility of work item tagging. Additionally, version 3.4.0.2 includes a minor update to the Telemetry.cs file, adding a comment for clarity without affecting the functionality of the telemetry initialization process. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.5.0.2) - Version 3.5.0.2 introduces significant enhancements to the Visual Studio Team Services Bulk Data Editor Engine, focusing on improved user experience and functionality. The documentation has been updated to clarify the capabilities of various mapping tools and processors, now featuring new field mapping options like FieldMergeMap and FieldBlankMap. Additionally, enhancements to the WorkItemUpdate and WorkItemDelete processors offer users greater flexibility and control during data migration and updates, making the process more efficient and user-friendly. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - Version 3.6.0.1 introduces significant enhancements to the migration process, particularly for test plans and variables. Notably, the `TestPlansAndSuitsMigrationContext` now includes logic to conditionally set the `AreaPath` and `Iteration` properties based on configuration values, providing users with greater flexibility during migrations. Additionally, the `TestVeriablesMigrationContext` has been improved to automatically create new test variables and their allowed values if they do not already exist, streamlining the management of test variables. These updates aim to enhance user experience and efficiency in migration tasks. -- [v4.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - The latest major release introduces a range of impactful enhancements aimed at improving user experience and flexibility during work item migration. A key feature is the new configuration option, `PrefixProjectToNodes`, which allows users to customize the prefixing of project names to area and iteration paths, as well as nodes, enhancing project structure management. The migration logic has been updated to support these options, streamlining the migration process. Additionally, users will benefit from improved documentation, including clearer installation instructions and new JSON configuration files. The release also includes an uninstall script for easier tool management and enhancements to caching and field exclusion during migrations, further refining the overall functionality. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.0.0.2) - Version 4.0.0.2 introduces a significant enhancement with the new configuration option, `PrefixProjectToNodes`, in the `WorkItemMigrationConfig` class. This feature allows users to customize whether the project name is prefixed to area and iteration paths during work item migration, providing greater flexibility in managing project structures. Additionally, the migration logic has been updated to support this new option, ensuring that area and iteration paths are constructed according to the user's preferences. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.1.0.2) - Version 4.1 introduces significant user-impacting changes aimed at enhancing migration workflows. The update includes a new configuration option, `PrefixProjectToNodes`, in the `NodeStructuresMigrationConfig` class, allowing users to choose whether project names should be prefixed to nodes during migration, thereby increasing flexibility in node structure processing. Additionally, the migration context has been improved to utilize this new option. Furthermore, the update enhances the WorkItemMigrationContext by replacing hardcoded project names for AreaPath and IterationPath with dynamic references to the new work item's project name, further streamlining project migration configurations. Lastly, the project and license URLs in the `.nuspec` file have been updated to reflect the new repository location. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.2.0) - Version 4.2.0, released on October 12, 2016, introduces significant user-impacting changes, including the addition of a Chocolatey package for the VSTS Sync Migrator, complete with a PowerShell installation script and nuspec file for streamlined installation and management. Furthermore, the update enhances the Test Plans and Suits migration configuration by introducing a new option, `PrefixProjectToNodes`, enabling users to customize how project names are prefixed during the migration process. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.3.0) - Version 4.3.0 introduces several user-impacting changes, including an updated `next-version` in the GitVersion configuration, now set to 4.2.0. A new uninstall script for the VSTS Sync Migration tool has been added, enhancing user experience during tool management. The package metadata has been improved with a new ID format and the inclusion of an icon URL. Additionally, users will benefit from new JSON configuration files in the documentation, which now offers clearer instructions for obtaining the tools, with a strong recommendation for installation via Chocolatey. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - Version 4.4.0, released on October 18, 2016, brings significant user-facing enhancements, including updated README and documentation that clarify installation options for the VSTS Bulk Data Editor Engine. Users can now choose from recommended methods such as installing via Chocolatey, downloading the latest release from GitHub, or creating custom tools using the NuGet package. Additionally, the `FindReflectedWorkItem` method has been improved with a new caching option, and an ignore list feature has been introduced to allow users to exclude specific fields during work item migration, enhancing overall functionality and user experience. -- [v5.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - The latest major release brings a host of impactful changes designed to enhance user experience and functionality. Key updates include a rebranding to "VSTS Sync Migration Tools" and a simplified command name for installation and uninstallation. Users can now benefit from the new `MultiValueConditionalMapConfig` class, which allows for more complex field mapping configurations. Version 5.1 introduces customizable user preferences and improved command-line functionality, while 5.3 enhances the migration process for test plans with a new method for handling test cases, updates to installation scripts for better package verification, and optimizations in field merging. Comprehensive new documentation supports these changes, ensuring users can easily adapt to the updated features and configurations. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.0.1) - Version 5.0 introduces significant user-impacting changes, including a rebranding from "VSTS Bulk Data Editor & Migrator" to "VSTS Sync Migration Tools" and a streamlined command name change from `vstssyncmigration` to `vsts-sm` for installation and uninstallation. The update also features the new `MultiValueConditionalMapConfig` class, which enhances field mapping flexibility by allowing complex configurations with multiple source and target field values. Additionally, comprehensive new documentation has been provided to assist users with configuration and usage, reflecting updated command structures and new options for processing work items and links. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.1.0) - Version 5.1.0, released on October 19, 2016, brings significant user-impacting changes, including new configuration options that allow for greater customization of user preferences. Enhancements to existing command-line flags improve functionality, making it easier for users to execute commands efficiently. Additionally, adjustments to default settings have been made to streamline the overall user experience, ensuring a more intuitive interaction with the software. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - Version 5.3 introduces several user-impacting changes, including the addition of a new method, `ProcessChildTestCases`, in the `TestPlansAndSuitsMigrationContext` class, which streamlines the migration process for test plans and suites by enabling the handling of test cases. The release also updates the GitVersion configuration to reflect the new version, enhances Chocolatey installation scripts with a checksum for improved package verification, and introduces a `doneMatch` property in the field mapping configuration to optimize field merging by preventing the reprocessing of already merged fields. Additionally, new documentation has been provided to facilitate user onboarding. -- [v6.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - The latest major release brings a host of impactful changes for users. A key highlight is the rebranding of the command-line tool to `vstssyncmigrator`, accompanied by updated documentation to assist with the new command structure. Enhancements to attachment export and import migration contexts improve ID formatting, while the restructuring of project organization may necessitate updates to project references. Users will also benefit from improved global configuration documentation, with various processors now enabled by default for immediate functionality. New features include the `WorkItemQueryMigrationContext`, allowing for selective migration of work item queries, and the option to prefix project names in folder paths for better organization. Enhanced logging and an updated FAQ section further support users in managing their migration processes effectively. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.0.2) - Version 6.0 introduces significant user-impacting changes, including a complete rebranding of the command-line tool from `vsts-sm` to `vstssyncmigrator`, which is reflected in updated documentation to guide users on the correct commands for setup and execution. The versioning has been updated in the GitVersion configuration, and the Chocolatey installation script has been modified to accommodate the new package name. Additionally, the release includes adjustments to attachment export and import migration contexts, enhancing the formatting of reflected IDs. Users should also note the restructuring of project organization, with various classes and namespaces renamed, which may require updates in their project references. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.1.0) - Version 6.1.0, released on January 24, 2017, brings significant user-impacting changes, including an update to the global configuration documentation for improved clarity on structure and options. A key enhancement is the change in the default state of various processors to enabled, allowing users to utilize functionality immediately upon configuration. The command-line documentation has also been improved to stress the importance of enabling processors for execution. Furthermore, this release includes enhancements in link migration handling and test plans, which provide better traceability and error management during the migration process. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.2.0) - Version 6.2.0 introduces significant user-impacting changes, including an updated `next-version` in the GitVersion configuration, now set to 6.2.0. A notable new feature is the `WorkItemQueryMigrationContext`, accompanied by the `WorkItemQueryMigrationConfig` class, which empowers users to enable or disable the migration of work item queries. Additionally, users can now choose to prefix project names in folder paths, providing enhanced flexibility and control over migration options. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - Version 6.3 introduces several user-impacting changes, including enhanced logging in the console application that notifies users of the current and latest available versions, encouraging timely upgrades. The release also features an updated FAQ section that clarifies the consistency requirement for the `PrefixProjectToNodes` setting and addresses potential migration errors. Additionally, improvements in documentation emphasize the need for users to customize their configuration files and ensure that processors are enabled for optimal functionality. -- [v7.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - The latest major release brings a host of user-focused enhancements and features designed to improve performance and usability. Key updates include a framework upgrade that boosts application performance and compatibility, alongside dependency updates for improved functionality and security. New configuration options allow for greater flexibility during data migration, including filtering elements by tags and replaying work item revisions. Enhancements to error handling and logging, as well as improvements in attachment management, contribute to a more reliable user experience. Additionally, the introduction of online status checks for version updates ensures users stay informed about the latest changes while connected to the internet. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.0.2) - Version 7.0 introduces several user-impacting changes, including a significant upgrade to the target framework from v4.5 to v4.6.2, enhancing overall application performance and compatibility. The update also includes dependency upgrades, notably `Newtonsoft.Json` to version 9.0.1 and `Microsoft.ApplicationInsights` to version 2.2.0, which may improve functionality and security. Subsequent releases, 7.0.1 and 7.0.2, further refine the user experience by implementing an online status check for version updates in the `VstsSyncMigrator.Console` application, ensuring users receive timely notifications only when connected to the internet. Additionally, version 7.0.2 comments out the conditional trace listener initialization in the telemetry logging, which may alter how telemetry data is captured during application execution. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.1.8) - Version 7.1 introduces several user-impacting changes, including the addition of a new configuration option, `OnlyElementsWithTag`, which allows users to filter elements during migration based on specified tags. The `FixGitCommitLinks` processor has been enhanced to support specifying a `TargetRepository`, improving flexibility in link fixing. Additionally, the `WorkItemRevisionReplayMigrationConfig` now enables users to replay all revisions of work items during migration. The release also includes updates to configuration files for better XML formatting and consistent assembly binding redirects, along with improvements in handling work item fields, ensuring a more streamlined and efficient user experience. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.2.0) - Version 7.2.0, released on August 1, 2017, introduces several user-impacting enhancements, particularly for the VSTS Sync Migration Tools. Key updates include an updated `next-version` in the `GitVersion.yml` file, now reflecting version 7.2.0, and improvements to the `vss-extension.json` file, which now features a repository link and updated support links. Users can continue to enjoy the same robust functionality for bulk editing and migrating work items in TFS and VSTS, ensuring a seamless experience with the latest version. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.4.2) - Version 7.4 introduces several user-impacting changes across its updates. In version 7.4.0, enhancements to the `FieldValuetoTagMap` class improve tag processing and display through better regular expression matching and formatting options. Version 7.4.1 adds a Contributor Covenant Code of Conduct to foster a respectful community, updates contributing guidelines for easier issue submissions, and upgrades key dependencies like Newtonsoft.Json and Microsoft.ApplicationInsights. Finally, version 7.4.2 improves the attachment download process by replacing the `WebClient` with a more efficient method from `WorkItemServer`, along with enhanced error logging for clearer exception messages. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - Version 7.5 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and features aimed at improving the migration experience. Key updates include the addition of new configuration options such as `ReplayRevisions`, `FieldtoFieldMultiMap`, and `TestPlanQueryBit`, which enhance flexibility in data migration and allow for more customized setups. The documentation has been significantly improved to provide clearer guidance on these new features and configuration requirements. Additionally, various bug fixes and performance optimizations have been implemented, including better error handling, improved logging, and refined attachment management processes, ensuring a more reliable and user-friendly migration experience. -- [v8.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - The latest major release introduces a range of impactful enhancements and features designed to improve user experience and streamline migration processes. Users can now take advantage of enhanced configuration options, including custom paths for configuration files and new modes for the `init` command. The migration process has been significantly refined with improved error handling, better logging, and new parameters for managing attachments and links. Notable features include the ability to sync changes post-migration, retry failed work item saves, and customize attachment handling. Additionally, the rebranding of the tool ensures users have access to accurate documentation and resources. Overall, these updates focus on providing greater control, efficiency, and clarity throughout the migration experience. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.0.17) - Version 8.0 introduces significant user-impacting changes, including enhanced configuration options for the `init` command, allowing users to specify custom configuration file paths and choose between `Full` and `WorkItemTracking` modes. The migration process has been improved with new parameters for handling attachments and links, as well as options for retrying failed work item creations. Users will benefit from updated documentation paths and improved error handling during attachment processing. Additionally, the removal of certain configuration options may affect users relying on those features, while new command-line options for TFS instance credentials enhance security and flexibility. Overall, these updates aim to improve the migration experience and streamline user interactions with the tool. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.1.9) - Version 8.1 of the Azure DevOps Migration Tools introduces several user-impacting changes aimed at enhancing functionality and user experience. Key updates include improved visibility with the console title now displaying the configuration file name and version, as well as new configuration options for querying work items, allowing for more flexible retrieval. Users will benefit from enhanced error handling during work item retrieval, better telemetry tracking for migration performance, and new parameters for team migration settings. Additionally, the versioning system has been refined to prevent compatibility issues, and users are now warned of configuration mismatches. Overall, these updates provide users with greater control, stability, and insights during the migration process. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.2.6) - Version 8.2 introduces several user-impacting changes aimed at enhancing the migration process. Key features include the new `GitRepoMapping` configuration option for defining source and target Git repository mappings, and improved error messaging for configuration mismatches. Users can now pause the migration after each work item for confirmation, and optional parameters have been added for saving work items and processing attachments. Enhancements in logging provide better insights into the migration process, while the restructuring of the `TestPlansAndSuitesMigrationContext` class improves metrics tracking and telemetry. Additionally, the assembly title has been updated to "Azure DevOps Migration Tools," which may affect localization interactions. Overall, these updates aim to streamline the migration experience and improve user control and visibility. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.3.8) - Version 8.3 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and fixes. Key features include the ability to sync changes post-migration and restart migrations at the revision level, significantly improving the migration process. The documentation has been enhanced for better user guidance, with clearer setup instructions and the addition of a new consultant for paid support options. Notable updates to package references enhance compatibility and performance, while minor corrections in the README and documentation ensure clarity in support information. Overall, this release focuses on improving user experience and streamlining migration processes. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.4.7) - Version 8.4 introduces significant user-impacting changes, including new configuration options such as `WorkItemCreateRetryLimit` for retrying failed work item saves and `FilterWorkItemsThatAlreadyExistInTarget` to streamline the migration process. The GitHub Actions workflow for managing stale issues and pull requests has been enhanced, now running daily and allowing exemptions for 'enhancement' labeled items. Additionally, the migration engine's console title now displays project names, and the project naming conventions have been updated for better clarity. Other improvements include refined tag handling and adjustments to SQL query formatting for enhanced readability. Overall, these updates aim to improve user experience and efficiency in project management and migration tasks. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.5.5) - Version 8.5 of the Azure DevOps Migration Tools introduces significant user-impacting changes, including a rebranding from "vsts-sync-migrator" to "azure-devops-migration-tools," ensuring users have accurate documentation and resources. Enhancements to repository querying capabilities allow for improved traceability and error handling during migrations, while validation checks for work item fields bolster data integrity. The update also modifies cross-project linking behavior, potentially affecting work item queries. Additionally, new configuration options for work item migration, such as attachment management and migration control features, provide users with greater flexibility and efficiency in their migration processes. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.6.9) - Version 8.6 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and fixes. Key features include improved handling of work item attachments and links, enhanced link validation for Git commit and pull request IDs, and refined project prefixing logic during team migrations. Users will benefit from a new Visual Studio Code task configuration for building projects, as well as updated documentation for changeset migration and cross-project linking. Additionally, the release addresses various bugs, such as ensuring only valid external links are processed and enhancing version management reliability. Users should note the removal of certain project files, which may require configuration adjustments. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.7.3) - Version 8.7 introduces several user-impacting changes aimed at enhancing the migration process and improving configuration management. Key features include a new GitHub Actions workflow for nightly merges, support for Personal Access Tokens in work item migration, and new settings for attachment migration, which allow users to customize attachment handling more effectively. Additionally, the configuration documentation has been updated to reflect these changes, including a new executable name and command options for initializing configuration files. The updates also refine the handling of work item and test point assignments during migration, ensuring a smoother user experience. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.8.0) - Version 8.8.0, released on February 21, 2020, introduces significant user-impacting changes aimed at enhancing migration processes. A new configuration option, `SkipToFinalRevisedWorkItemType`, allows users to seamlessly migrate work items by adopting the most recent revision's work item type when a type change is detected, particularly beneficial for migrations from Azure DevOps Service to Azure DevOps Server. Additionally, the `FilterWorkItemsThatAlreadyExistInTarget` option has been improved to boost migration efficiency by excluding work items that have already been migrated, streamlining the overall process for users. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - Version 8.9 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notably, version 8.9.10 modifies the method for finding reflected work items, requiring integer conversion for query IDs, and adds null checks for target plans, which may affect test suite management. Version 8.9.9 brings new configuration options to address migration errors and updates documentation for better clarity. Additionally, version 8.9.6 introduces structured issue templates for GitHub, facilitating user interaction for reporting bugs and suggesting features. The release also includes updates to support resources, streamlining migration processes, and enhancing code clarity through refactoring and the introduction of a new `.editorconfig` file. Overall, these updates aim to improve usability and streamline operations for users of the Azure DevOps Migration Tools. -- [v9.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - The latest major release brings a host of user-focused enhancements and improvements. Key features include multi-language support for Azure DevOps migrations, allowing for greater flexibility in handling different language versions. Users will benefit from improved configuration documentation, which now includes new fields for language mapping of Area and Iteration paths. Subsequent updates have introduced customizable field mappings, conditional logic for excluding specific work item types, and enhanced error handling for better troubleshooting. Additionally, logging capabilities have been significantly upgraded, providing more structured output and insights into application performance. Overall, these changes aim to streamline the migration process and improve user experience. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.0.1) - Version 9.0 introduces significant user-impacting changes, including the addition of multi-language support for migrating between different language versions of Azure DevOps, enhancing user flexibility. The configuration documentation has been improved to include new fields for language mapping of Area and Iteration paths, allowing users to specify these mappings for both source and target projects. Additionally, version 9.0.1 brings a new funding configuration file, deprecates the `doneMatch` property in the `FieldMergeMapConfig` class, improves error handling to prevent matching source and target fields, and enhances merging logic for better field updates. Users will also notice a change in the URI for the getting started guide in the extension's configuration. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.1.1) - Version 9.1 introduces significant enhancements to the migration process, focusing on user experience and flexibility. The new configuration option in version 9.1.0 allows users to define SourceToTargetFieldMappings, improving the customization of field mappings during migrations. Additionally, version 9.1.1 enhances the WorkItemMigrationContext class by implementing conditional logic to exclude "Test Plan" and "Test Suite" work item types from certain migrations, ensuring better handling of work item revisions and metrics. This update also improves the management of work item states and includes better logging for unsupported types, providing users with clearer insights during the migration process. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.2.0) - Version 9.2.0, released on August 21, 2020, introduces significant user-impacting changes, including an update to the configuration documentation that renames the key "LanguageMap" to "LanguageMaps" and corrects the mapping for "AreaPath" to "IterationPath," enhancing clarity in the configuration structure. Furthermore, error handling in the WorkItemQueryMigrationContext has been improved, offering more detailed logging of source and target queries during save failures, which will assist users in troubleshooting issues more effectively. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - Version 9.3 introduces significant enhancements, including an upgrade of the Microsoft.ApplicationInsights library to version 2.12.0, which improves application performance monitoring. The addition of Serilog enhances logging capabilities, providing users with more structured and detailed logging output. Furthermore, the update includes improved error handling and logging practices, transitioning from traditional trace logging to Serilog's framework, which may require users to adjust their log configuration and viewing methods. Overall, these changes aim to enhance user experience through better performance insights and more effective logging. -- [v10.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - The latest updates to the Migration Tools suite introduce a range of impactful enhancements for users. New projects, such as "MigrationTools.Sinks.AzureDevOps," have been added, along with a revamped console UI for improved Azure DevOps integration. Configuration management has been enhanced, allowing for easier JSON file loading and new telemetry settings. The migration engine has been optimized for better work item handling, and logging has been clarified. Users will need to update their configuration files due to a namespace change and new parameters for work item migration. Subsequent updates further simplify the configuration process, improve field mapping options, and enhance documentation for migrating test artifacts. Overall, these changes provide users with greater flexibility, control, and usability in their migration tasks. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.0.10) - Version 10.0 of the Migration Tools suite brings significant user-impacting changes, including the introduction of new projects like "MigrationTools.Sinks.AzureDevOps" and enhancements to the console UI for better integration with Azure DevOps. Users will benefit from improved configuration management, allowing for JSON file loading and new settings for telemetry and application insights. The migration engine has been streamlined with new interfaces for better work item handling, while logging has been enhanced for clarity. Additionally, users must update their configuration files due to a namespace change and the introduction of new parameters for work item migration, ensuring greater flexibility and control in their migration processes. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.1.1) - Version 10.1 introduces significant user-impacting changes aimed at enhancing the configuration experience. The design has been simplified to require only the class Name instead of the FullName, streamlining the setup process. Additionally, the ObjectType field has been updated to remove unnecessary prefixes, making it more user-friendly. Users will also benefit from updated configuration examples that incorporate new source and target project settings, including the addition of a Personal Access Token and various new field mapping options, which provide greater customization during migration tasks. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - Version 10.2 introduces significant user-impacting changes, including enhanced documentation for migrating test artifacts and work item types, and the addition of new consultants for support. Key improvements include the renaming of the `IWorkItemSink` interface to `IWorkItemMigrationSink`, new field mapping classes for better migration flexibility, and updates to logging capabilities with the introduction of an `ITelemetryLogger` interface. Users will benefit from improved error handling in logging, enhanced configuration options, and a more organized project structure. Additionally, minor documentation corrections and formatting updates enhance overall usability and clarity. -- [v11.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - The latest major release introduces a variety of impactful changes designed to enhance user experience and streamline migration processes. Key features include a rebranding of the project to "MigrationTools," improved configuration options, and enhanced error handling for migration operations. Users can now limit revisions during work item migrations, customize field retrieval, and benefit from new logging capabilities for better traceability. The introduction of new interfaces and methods, along with refined documentation, supports improved work item management and configuration flexibility. Overall, these updates aim to provide a more efficient, user-friendly migration experience while addressing previous bugs and enhancing system performance. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.0.2) - Version 11.0 introduces significant user-impacting changes, including a shift in project naming from "VstsSyncMigrator" to "MigrationTools," enhancing clarity for Azure DevOps and File System clients. The update streamlines configuration options and removes obsolete projects, improving usability for developers. Additionally, error handling in migration operations has been enhanced, providing better logging and exception management. The introduction of C# 9.0 support and new project references further optimizes the application's performance and configuration management, ensuring a smoother user experience. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.1.4) - Version 11.1 introduces several user-impacting changes aimed at enhancing flexibility and improving service management during migration processes. Key updates include the ability to conditionally register hosted services based on command-line arguments in version 11.1.4, allowing users to choose between initializing or executing services directly. Version 11.1.3 shifts the service registration for IMigrationClient from singleton to transient, affecting how services are instantiated. Additionally, version 11.1.2 features a renaming of the `MigrationOMClient` to `MigrationClient`, along with the introduction of the `IWorkItemMigrationClient` interface and a new `WorkItemMigrationClient` class, which enhance work item management capabilities. The overall structure has been refined to improve query handling and retrieval of work items. Other improvements include enhanced configuration handling in version 11.1.1 and updates to configuration files in version 11.1.0, ensuring a more consistent and user-friendly experience across the application. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.10.1) - Version 11.10 introduces significant user-impacting changes, including a new feature that allows users to limit the number of revisions migrated in the WorkItemMigration processor through the `MaxRevisions` option, enhancing control over migration processes. Additionally, version 11.10.1 improves error logging and debugging for the TfsWorkItemLinkEnricher, particularly in handling related links, providing more detailed log messages for various scenarios. However, users should note that a section related to revision limits in the TfsRevisionManager has been commented out, which may affect how revisions are processed and reported. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.11.27) - Version 11.11 introduces a range of user-impacting changes aimed at enhancing the Azure DevOps Migration Tools. Key features include the addition of a `YamlFilename` property in the `BuildDefinitions.cs` file, a new GitHub Actions workflow for project building and testing, and improved handling of work item queries through a factory for query builders. Users will benefit from enhanced flexibility with nullable boolean values in configuration options, the ability to filter test plans by area path, and new methods for retrieving pipeline definitions. Additionally, logging improvements provide clearer error messages, while various bug fixes and updates to package references enhance overall functionality and compatibility. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.12.23) - Version 11.12.23 introduces a significant enhancement with the addition of a new boolean parameter, `PrefixProjectToNodes`, in the `FixAreaPathAndIterationPathForTargetQuery` method, allowing users to control the inclusion of the project name in area path constructions during work item migration. This update is supported by multiple test cases to ensure accurate functionality. Additionally, previous versions have seen improvements in identity refresh processes, enhanced logging for better visibility, and new configuration options for migrating team member capacities and handling embedded images, all aimed at streamlining the migration experience and providing users with greater control and clarity throughout the process. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.2.1) - Version 11.2 introduces significant user-impacting changes, including enhancements to migration tools and work item management. In version 11.2.0, a new configuration option, "WorkItemDeleteConfig," allows users to control the deletion of work items based on specific queries, while the migration client has been refactored for improved efficiency in handling work item data. Version 11.2.1 further streamlines the migration process by integrating node structure migration into the updated `WorkItemMigrationConfig`, replacing the deprecated `NodeStructuresMigrationConfig`. Users can now specify `NodeBasePaths` directly within the migration configuration, and comprehensive documentation updates ensure that users have access to the latest configuration options. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.3.3) - Version 11.3 introduces several user-impacting changes aimed at improving the Azure DevOps Migration Tools experience. Notably, the migration context has been updated to retrieve project information from target work items, which may alter project migration configurations. Documentation enhancements include improved clarity in warnings, support for migrating between different language versions (specifically German to English), and a simplified configuration design. Additionally, the expected processor count in configuration tests has been adjusted, and query parameters have been renamed to better align with Work Item Query Language (WIQL), accompanied by new examples to aid users in crafting queries. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.4.3) - Version 11.4 introduces several user-impacting changes aimed at enhancing functionality and usability. Notably, the new "SampleConfigs" project provides users with sample configuration files, while the default setting for `LinkMigrationSaveEachAsAdded` in `configuration.json` simplifies initial setups. The update also streamlines the saving process of work items to Azure DevOps through the new `SaveToAzureDevOps` method, improving efficiency. Additionally, logging messages have been refined for better clarity, and the version retrieval method has been updated to ensure accurate version identification and upgrade prompts. Overall, these enhancements aim to improve user experience and operational clarity. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.5.18) - Version 11.5 introduces significant user-impacting changes, including a new configuration structure that enhances flexibility in managing migration settings. The `TeamProjectConfig` has been replaced with the `IMigrationClientConfig` interface, allowing for more dynamic configuration management. Users will benefit from improved clarity in configuration options, particularly with the renaming of query and order bits for better consistency. Enhancements to work item processing, error handling, and logging mechanisms have been implemented, making it easier to identify issues during migration. Additionally, the introduction of new mapping mechanisms for work item types and improved telemetry tracking will enhance the overall migration experience. Overall, these updates aim to streamline the migration process and improve user interaction with the tools. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.6.46) - Version 11.6 of the Azure DevOps Migration Tools brings significant user-impacting changes, including enhanced logging capabilities across various components, which will improve tracking and debugging during migration processes. Notably, the introduction of a new configuration option allows users to generate migration comments for work items, providing better traceability. The update also consolidates issue templates in the GitHub repository for streamlined reporting and enhances the migration of work items, test plans, and teams with improved bulk editing options. Additionally, users will benefit from clearer documentation and improved error handling, making the migration experience more robust and user-friendly. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.7.7) - Version 11.7 introduces several user-impacting changes aimed at enhancing the migration experience and improving system flexibility. Key features include the ability to customize fields retrieved for work items through optional parameters in the `RefreshWorkItem` and `AsWorkItemData` methods, as well as new properties in the `RevisionItem` class. The migration process is further streamlined with a stricter project retrieval method and improved error handling, ensuring users are informed during item queries. Additionally, the introduction of the `MigrationTools.ConsoleConfigGenerator` simplifies configuration file generation, while updates to authentication modes enhance user connectivity options. Overall, these enhancements aim to improve usability, data integrity, and performance across the migration tools. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.8.4) - Version 11.8 introduces several user-impacting changes aimed at enhancing configuration management and coding standards. Key features include the introduction of a default configuration file ("configuration.json") for the MigrationTools application, which is now essential for execution, and a new inferred `.editorconfig` file that provides comprehensive C# coding style rules for better customization. The release also standardizes contributions with a new pull request template and adds a `RefName` option across various configurations for improved referencing. Additionally, updates to logging configurations and enhanced error handling in the TfsReflectedWorkItemId class improve overall usability and functionality. Users are advised to update their configurations accordingly to align with the new standards. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - Version 11.9 of the Azure DevOps Migration Tools brings significant enhancements and new features aimed at improving user experience and migration capabilities. Key updates include the introduction of the `TfsRevisionManager`, allowing users to configure revision settings for migration, and support for migrating `Processes`, alongside existing features like `Work Items` and `Pipelines`. The release also enhances logging for better insights during migrations, updates configuration options for clarity, and integrates new methods for managing task groups and variable groups. Additionally, several bug fixes and improvements have been made to streamline the migration process, ensuring a more efficient and user-friendly experience. -- [v12.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - The latest major release brings a host of enhancements designed to improve user experience and streamline migration processes. New configuration options for migration processors offer greater flexibility, allowing users to define custom remapping rules for area and iteration paths. Significant improvements in field mapping configurations and enhanced documentation provide clearer guidance for users. The introduction of features like case-insensitive matching for regular expressions and new parameters for work item migration enhances functionality. Additionally, updates to logging, error handling, and overall documentation structure ensure a more robust and user-friendly experience. Various bug fixes further contribute to the reliability and clarity of the migration tools, making the overall process smoother for users. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.0.38) - Version 12.0 introduces significant enhancements and features aimed at improving user experience and migration processes. Key updates include the introduction of new configuration options for migration processors, such as `TestPlanQueryBit` and `UseCommonNodeStructureEnricherConfig`, which enhance flexibility in migrating test plans and suites. Users can now define custom remapping rules for area and iteration paths using `AreaMaps` and `IterationMaps`. Additionally, the migration tools have seen improvements in field mapping configurations, including a new Azure DevOps consultant in the documentation, and enhancements to the mapping display name functionality. The release also addresses various bugs and usability issues, such as improved error handling during work item migrations and refined documentation for better clarity. Overall, these updates aim to streamline the migration process and provide users with more control and flexibility. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.1.1) - Version 12.1 introduces several user-impacting changes aimed at enhancing functionality and usability. The release of version 12.1.0 includes updates to the MigrationTools solution, adding a new `_config.yml` documentation file and renaming the "Primary Contributors" section to "Primary Contributors & Consultants" for clarity. Additionally, the FieldMergeMap configuration method has been streamlined by removing unnecessary validation code, simplifying the configuration process. In version 12.1.1, a significant improvement is made with the introduction of case-insensitive matching for regular expressions in the TfsNodeStructure.cs file, which enhances flexibility in path recognition and error handling during the mapping and validation processes. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.2.1) - Version 12.2 introduces significant user-impacting changes, including enhancements to the WorkItemMigrationConfig processor in version 12.2.1, which now features new parameters like ReplayRevisions and UpdateCreatedBy, allowing for more control over work item migration. The documentation has also been updated to provide clearer guidance on WIQL queries and migration settings. In version 12.2.0, new documentation files for Endpoint Enrichers and Field Maps have been added, detailing configurations and including example JSON setups. Additionally, improvements to the `KeepOutboundLinkTargetProcessor` and overall documentation structure enhance clarity and accessibility for users. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.3.11) - Version 12.3 introduces several user-impacting changes aimed at enhancing the migration experience in Azure DevOps. Key features include the new `TreeToTagMapConfig` for improved organization of work items, and the `ExportProfilePictureFromADConfig` for seamless profile updates. Enhancements to team migration and test plans allow for better management and flexibility, while the addition of the `SkipRevisionWithInvalidAreaPath` option improves the handling of work items during migration. Documentation updates clarify configuration parameters and execution sequences, ensuring users have the necessary guidance for effective use. Bug fixes and improvements, such as null value handling and consistent naming conventions, further enhance the robustness and clarity of the migration tools. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.5.0) - Version 12.5.0, released on February 24, 2023, introduces significant user-impacting changes, including a new versioning scheme in the GitVersion configuration, which sets the next version to 12.5.0. The update also renames the 'master' branch to 'main' and refines branch regex patterns for both release and preview tags. Additionally, it removes the outdated GitVersion2.yml file and adds a new binary executable for GitVersion, enhancing overall usability and streamlining version management. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.6.2) - Version 12.6 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notably, version 12.6.1 adds new variables to the TfsWorkItemEmbededLinkEnricher, enabling more accurate replacement of project-specific links during migration. Version 12.6.0 enhances user support by updating the issue template to direct users to GitHub discussions for inquiries and feature suggestions, while also introducing a new configuration option, `ShouldCreateMissingRevisionPaths`, which allows users to manage the creation of missing revision paths. Additionally, version 12.6.2 modifies application shutdown behavior by removing certain method calls and logging statements, potentially affecting how users handle application exits. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.7.1) - Version 12.7 introduces significant user-impacting changes, including enhancements to configuration options and improved logging. In version 12.7.0, the `FieldBlankMapConfig` has been renamed to `FieldSkipMapConfig`, allowing users to skip populating existing fields, while a new `FieldClearMapConfig` enables setting populated fields to null. Documentation has been updated to reflect these changes. The subsequent release, version 12.7.1, adds a new `CommonEnrichersConfig` section for node structure processing and modifies the `UseCommonNodeStructureEnricherConfig` option to enable shared configuration for enrichment. Additionally, the migration configuration now includes the `LinkMigrationSaveEachAsAdded` option, and logging improvements have been made for validation processes related to target nodes. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - Version 12.8 introduces several user-impacting changes aimed at enhancing functionality and improving the overall experience. Key features include the addition of the `jekyll-redirect-from` gem for better redirect management, updates to the `_config.yml` file for new permalink settings, and the reinstatement of the `jekyll-optional-front-matter` gem. Documentation has been significantly improved, with clearer guidance on Azure DevOps endpoints and enhanced metadata for easier navigation. New GitHub Actions workflows for validating pull requests and updates to the Gemfile reflect dependency enhancements. Additionally, various bug fixes and performance improvements have been implemented, ensuring a smoother migration process for users. -- [v13.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - The latest updates bring a range of enhancements and new features aimed at improving user experience and functionality. A key addition is the `WorkItemMigrationContext` processor, which facilitates the migration of work items, including their history and attachments, between Azure DevOps instances. Users will find clearer documentation and a new configuration file to simplify work item type and field mappings. The introduction of the `ExportUsersForMapping` feature allows for easy JSON file exports for field mapping, while security is bolstered with an updated authentication mode. Users can now disable telemetry collection during migration, and various improvements have been made to migration behavior and configuration settings, enhancing the overall robustness and integrity of the migration tools. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.0.9) - Version 13.0 introduces several user-impacting changes, including the new `WorkItemMigrationContext` processor that enhances the migration of work items, their history, attachments, and metadata between Azure DevOps instances. Users will benefit from improved documentation clarity, with updates to the TfsWorkItemEndpoint and migration tool instructions. A new configuration file, `configuration2-wit.json`, has been added to streamline work item type and field mappings. Additionally, enhancements to the handling of service connections during pipeline creation and the introduction of a bug report template in the GitHub repository aim to improve user experience and support. Overall, these updates enhance functionality, flexibility, and clarity for users engaging with the migration tools and documentation. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.1.1) - Version 13.1 introduces several user-impacting changes, including the new `ExportUsersForMapping` feature, which allows users to export a JSON file for field mapping. The authentication mode has been updated from "AccessToken" to "Prompt," enhancing security and user experience. Additionally, a new command-line option to disable telemetry collection has been added, which can be set during migration with `--telemetry off`, and this option is now included in the default launch settings. Documentation has been updated to reflect these changes and provide guidance on managing telemetry settings, alongside various enhancements and updates to NuGet package versions for improved functionality. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - Version 13.2 introduces significant user-impacting changes, including enhancements to migration behavior and configuration settings. In version 13.2.0, the configuration file was updated to enable the creation of missing revision paths and activate the work item migration processor, while the user export processor was disabled. A new command line flag was also added to disable telemetry. The subsequent release, 13.2.1, further refines these features by updating the `StopMigrationOnMissingAreaIterationNodes` option to true and `ShouldCreateMissingRevisionPaths` to false, which may affect migration processes. Additionally, it improves the migration tool's robustness with a null check for `executeOptions` and enhances data integrity through validation checks in the `TestPlansAndSuitesMigrationContext`. -- [v14.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - The latest major release brings a host of user-focused enhancements and improvements. Key changes include the adoption of Winget as the primary installation method, making it easier for users to get started. The main executable has been renamed to `devopsmigration.exe`, and new configuration options enhance customization capabilities, including parallel builds and test case timeouts. The command for initializing configurations has been updated for greater flexibility, and logging improvements provide better insights during migration operations. Subsequent updates have refined version detection, improved command line arguments, and introduced new configuration files to prevent blank issues. Enhanced logging and error handling further improve user experience, while package upgrades and better handling of specific fields streamline migration processes. Overall, these updates aim to enhance functionality, usability, and reliability for users. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.0.3) - Version 14.0 introduces significant user-impacting changes, including a shift to Winget as the primary installation method, enhancing accessibility for users. The main executable has been renamed to `devopsmigration.exe`, streamlining command execution. New configuration options, such as `ShouldCreateMissingRevisionPaths` and the `MigrationTools.lutconfig` file, allow for improved customization, including parallel builds and test case timeouts. The command for creating default configurations has been updated to `devopsmigration init`, with added flexibility through the `--options` parameter. Additionally, logging improvements provide better context during migration operations, ensuring users have detailed insights into package management and version detection. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.1.0) - Version 14.1.0, released on October 26, 2023, introduces several user-impacting changes aimed at improving functionality and debugging. Notably, the command line arguments in the launch settings for the initialization command have been updated, with the removal of the "skipVersionCheck" option to enhance version accuracy. The version detection logic has also been refined, improving how the running version is retrieved and displayed. Furthermore, the project now utilizes an updated version of the WGet.NET package, and logging verbosity has been enhanced, providing users with better insights for debugging purposes. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.2.3) - Version 14.2 introduces several user-impacting changes aimed at enhancing functionality and usability. Key updates include a new configuration file for issue templates that prevents blank issues and provides users with resources for questions and feature suggestions. The command line arguments have been updated, changing the configuration file path format and modifying the default options for the 'init' command from 'Full' to 'Basic', alongside the introduction of a new 'Basic' option in the options mode. Users can now also utilize a 'Reference' option in the configuration builder for generating various configurations. Additionally, the requirement for a Personal Access Token (PAT) during Azure DevOps migration has been enforced. The release also improves documentation with new Git-related properties, updates to dependencies for better performance, and enhanced logging for debugging during migrations. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.3.11) - Version 14.3 introduces significant user-impacting changes, including enhancements to the TFS Node Structure processor with the new `ReplicateAllExistingNodes` parameter, and updates to work item migration configurations that affect how existing items are managed. The removal of certain options like `ShouldCreateNodesUpFront` and `skipToFinalRevisedWorkItemType` simplifies migration logic, while improved logging and error handling in the TestPlansAndSuitesMigrationContext enhance user feedback during operations. Additionally, the Git metadata has been updated across several releases to reflect the latest commit details, ensuring users have the most current information. Overall, these updates aim to streamline migration processes and improve user experience. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - Version 14.4 introduces several user-impacting changes, including the addition of Azure DevOps Server 2022 to the bug issue template, enhancing clarity for users during issue reporting. Improvements to the handling of the "ClosedDate" field now allow for better migration processes, with detailed logging to alert users of potential issues. The update also includes significant package upgrades that enhance logging and dependency injection capabilities. Additionally, refinements in the detection services improve how package versions are retrieved and managed. Overall, these updates aim to streamline user experience and improve the reliability of the migration tools. - [v15.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.1.7) - The latest release brings a host of enhancements and fixes designed to improve user experience and configuration options. Noteworthy features include a new GitHub Actions workflow for automatic updates to pull request titles, enhanced management of area and iteration paths using regex mapping, and a more streamlined query format for migration configurations. Users can now enjoy greater flexibility in configuring attachment processing, including options for export paths and size limits. Additionally, updates to authentication methods and improved logging for user retrieval processes have been implemented. The release also addresses various bugs and makes adjustments to enhance overall functionality. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.0.4) - Version 15.0 introduces significant enhancements and fixes to the Azure DevOps Migration Tools, focusing on user experience and configuration flexibility. Key updates include the introduction of a new GitHub Actions workflow for automatic pull request title updates, improved management of area and iteration paths through regex mapping, and a streamlined query format for migration configurations. Users can now configure attachment processing more flexibly with options for export paths and maximum sizes directly through the TfsAttachmentEnricherOptions. Additionally, authentication methods have been updated, and enhanced logging for user retrieval processes has been implemented. Various bug fixes and adjustments have also been made to improve overall functionality and user experience. - - [v](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.1.7) - Version 15.1 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notable features include the introduction of a new configuration for bulk editing work items, enhanced GitHub workflows for automated pull request labeling and code reviews, and improved logging and error handling across various components. Users will benefit from updated documentation reflecting these changes, as well as new options for work item processing and streamlined project structures. Additionally, the release includes updates to the Azure pipeline configurations and support for .NET 8.0, ensuring a more efficient and robust migration process. + - [v15.1.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.1.7) - Version 15.1 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notable features include the introduction of a new configuration for bulk editing work items, enhanced GitHub workflows for automated pull request labeling and code reviews, and improved logging and error handling across various components. Users will benefit from updated documentation reflecting these changes, as well as new options for work item processing and streamlined project structures. Additionally, the release includes updates to the Azure pipeline configurations and support for .NET 8.0, ensuring a more efficient and robust migration process. + - [v15.0.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.0.4) - Version 15.0 introduces significant enhancements and fixes to the Azure DevOps Migration Tools, focusing on user experience and configuration flexibility. Key updates include the introduction of a new GitHub Actions workflow for automatic pull request title updates, improved management of area and iteration paths through regex mapping, and a streamlined query format for migration configurations. Users can now configure attachment processing more flexibly with options for export paths and maximum sizes directly through the TfsAttachmentEnricherOptions. Additionally, authentication methods have been updated, and enhanced logging for user retrieval processes has been implemented. Various bug fixes and adjustments have also been made to improve overall functionality and user experience. +- [v14.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - The latest major release brings a host of user-focused enhancements and improvements. Key changes include the adoption of Winget as the primary installation method, making it easier for users to get started. The main executable has been renamed to `devopsmigration.exe`, and new configuration options enhance customization capabilities, including parallel builds and test case timeouts. The command for initializing configurations has been updated for greater flexibility, and logging improvements provide better insights during migration operations. Subsequent updates have refined version detection, improved command line arguments, and introduced new configuration files to prevent blank issues. Enhanced logging and error handling further improve user experience, while package upgrades and better handling of specific fields streamline migration processes. Overall, these updates aim to enhance functionality, usability, and reliability for users. + - [v14.4.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - Version 14.4 introduces several user-impacting changes, including the addition of Azure DevOps Server 2022 to the bug issue template, enhancing clarity for users during issue reporting. Improvements to the handling of the "ClosedDate" field now allow for better migration processes, with detailed logging to alert users of potential issues. The update also includes significant package upgrades that enhance logging and dependency injection capabilities. Additionally, refinements in the detection services improve how package versions are retrieved and managed. Overall, these updates aim to streamline user experience and improve the reliability of the migration tools. + - [v14.3.11](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.3.11) - Version 14.3 introduces significant user-impacting changes, including enhancements to the TFS Node Structure processor with the new `ReplicateAllExistingNodes` parameter, and updates to work item migration configurations that affect how existing items are managed. The removal of certain options like `ShouldCreateNodesUpFront` and `skipToFinalRevisedWorkItemType` simplifies migration logic, while improved logging and error handling in the TestPlansAndSuitesMigrationContext enhance user feedback during operations. Additionally, the Git metadata has been updated across several releases to reflect the latest commit details, ensuring users have the most current information. Overall, these updates aim to streamline migration processes and improve user experience. + - [v14.2.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.2.3) - Version 14.2 introduces several user-impacting changes aimed at enhancing functionality and usability. Key updates include a new configuration file for issue templates that prevents blank issues and provides users with resources for questions and feature suggestions. The command line arguments have been updated, changing the configuration file path format and modifying the default options for the 'init' command from 'Full' to 'Basic', alongside the introduction of a new 'Basic' option in the options mode. Users can now also utilize a 'Reference' option in the configuration builder for generating various configurations. Additionally, the requirement for a Personal Access Token (PAT) during Azure DevOps migration has been enforced. The release also improves documentation with new Git-related properties, updates to dependencies for better performance, and enhanced logging for debugging during migrations. + - [v14.1.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.1.0) - Version 14.1.0, released on October 26, 2023, introduces several user-impacting changes aimed at improving functionality and debugging. Notably, the command line arguments in the launch settings for the initialization command have been updated, with the removal of the "skipVersionCheck" option to enhance version accuracy. The version detection logic has also been refined, improving how the running version is retrieved and displayed. Furthermore, the project now utilizes an updated version of the WGet.NET package, and logging verbosity has been enhanced, providing users with better insights for debugging purposes. + - [v14.0.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.0.3) - Version 14.0 introduces significant user-impacting changes, including a shift to Winget as the primary installation method, enhancing accessibility for users. The main executable has been renamed to `devopsmigration.exe`, streamlining command execution. New configuration options, such as `ShouldCreateMissingRevisionPaths` and the `MigrationTools.lutconfig` file, allow for improved customization, including parallel builds and test case timeouts. The command for creating default configurations has been updated to `devopsmigration init`, with added flexibility through the `--options` parameter. Additionally, logging improvements provide better context during migration operations, ensuring users have detailed insights into package management and version detection. +- [v13.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - The latest updates bring a range of enhancements and new features aimed at improving user experience and functionality. A key addition is the `WorkItemMigrationContext` processor, which facilitates the migration of work items, including their history and attachments, between Azure DevOps instances. Users will find clearer documentation and a new configuration file to simplify work item type and field mappings. The introduction of the `ExportUsersForMapping` feature allows for easy JSON file exports for field mapping, while security is bolstered with an updated authentication mode. Users can now disable telemetry collection during migration, and various improvements have been made to migration behavior and configuration settings, enhancing the overall robustness and integrity of the migration tools. + - [v13.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - Version 13.2 introduces significant user-impacting changes, including enhancements to migration behavior and configuration settings. In version 13.2.0, the configuration file was updated to enable the creation of missing revision paths and activate the work item migration processor, while the user export processor was disabled. A new command line flag was also added to disable telemetry. The subsequent release, 13.2.1, further refines these features by updating the `StopMigrationOnMissingAreaIterationNodes` option to true and `ShouldCreateMissingRevisionPaths` to false, which may affect migration processes. Additionally, it improves the migration tool's robustness with a null check for `executeOptions` and enhances data integrity through validation checks in the `TestPlansAndSuitesMigrationContext`. + - [v13.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.1.1) - Version 13.1 introduces several user-impacting changes, including the new `ExportUsersForMapping` feature, which allows users to export a JSON file for field mapping. The authentication mode has been updated from "AccessToken" to "Prompt," enhancing security and user experience. Additionally, a new command-line option to disable telemetry collection has been added, which can be set during migration with `--telemetry off`, and this option is now included in the default launch settings. Documentation has been updated to reflect these changes and provide guidance on managing telemetry settings, alongside various enhancements and updates to NuGet package versions for improved functionality. + - [v13.0.9](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.0.9) - Version 13.0 introduces several user-impacting changes, including the new `WorkItemMigrationContext` processor that enhances the migration of work items, their history, attachments, and metadata between Azure DevOps instances. Users will benefit from improved documentation clarity, with updates to the TfsWorkItemEndpoint and migration tool instructions. A new configuration file, `configuration2-wit.json`, has been added to streamline work item type and field mappings. Additionally, enhancements to the handling of service connections during pipeline creation and the introduction of a bug report template in the GitHub repository aim to improve user experience and support. Overall, these updates enhance functionality, flexibility, and clarity for users engaging with the migration tools and documentation. +- [v12.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - The latest major release brings a host of enhancements designed to improve user experience and streamline migration processes. New configuration options for migration processors offer greater flexibility, allowing users to define custom remapping rules for area and iteration paths. Significant improvements in field mapping configurations and enhanced documentation provide clearer guidance for users. The introduction of features like case-insensitive matching for regular expressions and new parameters for work item migration enhances functionality. Additionally, updates to logging, error handling, and overall documentation structure ensure a more robust and user-friendly experience. Various bug fixes further contribute to the reliability and clarity of the migration tools, making the overall process smoother for users. + - [v12.8.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - Version 12.8 introduces several user-impacting changes aimed at enhancing functionality and improving the overall experience. Key features include the addition of the `jekyll-redirect-from` gem for better redirect management, updates to the `_config.yml` file for new permalink settings, and the reinstatement of the `jekyll-optional-front-matter` gem. Documentation has been significantly improved, with clearer guidance on Azure DevOps endpoints and enhanced metadata for easier navigation. New GitHub Actions workflows for validating pull requests and updates to the Gemfile reflect dependency enhancements. Additionally, various bug fixes and performance improvements have been implemented, ensuring a smoother migration process for users. + - [v12.7.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.7.1) - Version 12.7 introduces significant user-impacting changes, including enhancements to configuration options and improved logging. In version 12.7.0, the `FieldBlankMapConfig` has been renamed to `FieldSkipMapConfig`, allowing users to skip populating existing fields, while a new `FieldClearMapConfig` enables setting populated fields to null. Documentation has been updated to reflect these changes. The subsequent release, version 12.7.1, adds a new `CommonEnrichersConfig` section for node structure processing and modifies the `UseCommonNodeStructureEnricherConfig` option to enable shared configuration for enrichment. Additionally, the migration configuration now includes the `LinkMigrationSaveEachAsAdded` option, and logging improvements have been made for validation processes related to target nodes. + - [v12.6.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.6.2) - Version 12.6 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notably, version 12.6.1 adds new variables to the TfsWorkItemEmbededLinkEnricher, enabling more accurate replacement of project-specific links during migration. Version 12.6.0 enhances user support by updating the issue template to direct users to GitHub discussions for inquiries and feature suggestions, while also introducing a new configuration option, `ShouldCreateMissingRevisionPaths`, which allows users to manage the creation of missing revision paths. Additionally, version 12.6.2 modifies application shutdown behavior by removing certain method calls and logging statements, potentially affecting how users handle application exits. + - [v12.5.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.5.0) - Version 12.5.0, released on February 24, 2023, introduces significant user-impacting changes, including a new versioning scheme in the GitVersion configuration, which sets the next version to 12.5.0. The update also renames the 'master' branch to 'main' and refines branch regex patterns for both release and preview tags. Additionally, it removes the outdated GitVersion2.yml file and adds a new binary executable for GitVersion, enhancing overall usability and streamlining version management. + - [v12.3.11](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.3.11) - Version 12.3 introduces several user-impacting changes aimed at enhancing the migration experience in Azure DevOps. Key features include the new `TreeToTagMapConfig` for improved organization of work items, and the `ExportProfilePictureFromADConfig` for seamless profile updates. Enhancements to team migration and test plans allow for better management and flexibility, while the addition of the `SkipRevisionWithInvalidAreaPath` option improves the handling of work items during migration. Documentation updates clarify configuration parameters and execution sequences, ensuring users have the necessary guidance for effective use. Bug fixes and improvements, such as null value handling and consistent naming conventions, further enhance the robustness and clarity of the migration tools. + - [v12.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.2.1) - Version 12.2 introduces significant user-impacting changes, including enhancements to the WorkItemMigrationConfig processor in version 12.2.1, which now features new parameters like ReplayRevisions and UpdateCreatedBy, allowing for more control over work item migration. The documentation has also been updated to provide clearer guidance on WIQL queries and migration settings. In version 12.2.0, new documentation files for Endpoint Enrichers and Field Maps have been added, detailing configurations and including example JSON setups. Additionally, improvements to the `KeepOutboundLinkTargetProcessor` and overall documentation structure enhance clarity and accessibility for users. + - [v12.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.1.1) - Version 12.1 introduces several user-impacting changes aimed at enhancing functionality and usability. The release of version 12.1.0 includes updates to the MigrationTools solution, adding a new `_config.yml` documentation file and renaming the "Primary Contributors" section to "Primary Contributors & Consultants" for clarity. Additionally, the FieldMergeMap configuration method has been streamlined by removing unnecessary validation code, simplifying the configuration process. In version 12.1.1, a significant improvement is made with the introduction of case-insensitive matching for regular expressions in the TfsNodeStructure.cs file, which enhances flexibility in path recognition and error handling during the mapping and validation processes. + - [v12.0.38](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.0.38) - Version 12.0 introduces significant enhancements and features aimed at improving user experience and migration processes. Key updates include the introduction of new configuration options for migration processors, such as `TestPlanQueryBit` and `UseCommonNodeStructureEnricherConfig`, which enhance flexibility in migrating test plans and suites. Users can now define custom remapping rules for area and iteration paths using `AreaMaps` and `IterationMaps`. Additionally, the migration tools have seen improvements in field mapping configurations, including a new Azure DevOps consultant in the documentation, and enhancements to the mapping display name functionality. The release also addresses various bugs and usability issues, such as improved error handling during work item migrations and refined documentation for better clarity. Overall, these updates aim to streamline the migration process and provide users with more control and flexibility. +- [v11.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - The latest major release introduces a variety of impactful changes designed to enhance user experience and streamline migration processes. Key features include a rebranding of the project to "MigrationTools," improved configuration options, and enhanced error handling for migration operations. Users can now limit revisions during work item migrations, customize field retrieval, and benefit from new logging capabilities for better traceability. The introduction of new interfaces and methods, along with refined documentation, supports improved work item management and configuration flexibility. Overall, these updates aim to provide a more efficient, user-friendly migration experience while addressing previous bugs and enhancing system performance. + - [v11.9.55](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - Version 11.9 of the Azure DevOps Migration Tools brings significant enhancements and new features aimed at improving user experience and migration capabilities. Key updates include the introduction of the `TfsRevisionManager`, allowing users to configure revision settings for migration, and support for migrating `Processes`, alongside existing features like `Work Items` and `Pipelines`. The release also enhances logging for better insights during migrations, updates configuration options for clarity, and integrates new methods for managing task groups and variable groups. Additionally, several bug fixes and improvements have been made to streamline the migration process, ensuring a more efficient and user-friendly experience. + - [v11.8.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.8.4) - Version 11.8 introduces several user-impacting changes aimed at enhancing configuration management and coding standards. Key features include the introduction of a default configuration file ("configuration.json") for the MigrationTools application, which is now essential for execution, and a new inferred `.editorconfig` file that provides comprehensive C# coding style rules for better customization. The release also standardizes contributions with a new pull request template and adds a `RefName` option across various configurations for improved referencing. Additionally, updates to logging configurations and enhanced error handling in the TfsReflectedWorkItemId class improve overall usability and functionality. Users are advised to update their configurations accordingly to align with the new standards. + - [v11.7.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.7.7) - Version 11.7 introduces several user-impacting changes aimed at enhancing the migration experience and improving system flexibility. Key features include the ability to customize fields retrieved for work items through optional parameters in the `RefreshWorkItem` and `AsWorkItemData` methods, as well as new properties in the `RevisionItem` class. The migration process is further streamlined with a stricter project retrieval method and improved error handling, ensuring users are informed during item queries. Additionally, the introduction of the `MigrationTools.ConsoleConfigGenerator` simplifies configuration file generation, while updates to authentication modes enhance user connectivity options. Overall, these enhancements aim to improve usability, data integrity, and performance across the migration tools. + - [v11.6.46](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.6.46) - Version 11.6 of the Azure DevOps Migration Tools brings significant user-impacting changes, including enhanced logging capabilities across various components, which will improve tracking and debugging during migration processes. Notably, the introduction of a new configuration option allows users to generate migration comments for work items, providing better traceability. The update also consolidates issue templates in the GitHub repository for streamlined reporting and enhances the migration of work items, test plans, and teams with improved bulk editing options. Additionally, users will benefit from clearer documentation and improved error handling, making the migration experience more robust and user-friendly. + - [v11.5.18](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.5.18) - Version 11.5 introduces significant user-impacting changes, including a new configuration structure that enhances flexibility in managing migration settings. The `TeamProjectConfig` has been replaced with the `IMigrationClientConfig` interface, allowing for more dynamic configuration management. Users will benefit from improved clarity in configuration options, particularly with the renaming of query and order bits for better consistency. Enhancements to work item processing, error handling, and logging mechanisms have been implemented, making it easier to identify issues during migration. Additionally, the introduction of new mapping mechanisms for work item types and improved telemetry tracking will enhance the overall migration experience. Overall, these updates aim to streamline the migration process and improve user interaction with the tools. + - [v11.4.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.4.3) - Version 11.4 introduces several user-impacting changes aimed at enhancing functionality and usability. Notably, the new "SampleConfigs" project provides users with sample configuration files, while the default setting for `LinkMigrationSaveEachAsAdded` in `configuration.json` simplifies initial setups. The update also streamlines the saving process of work items to Azure DevOps through the new `SaveToAzureDevOps` method, improving efficiency. Additionally, logging messages have been refined for better clarity, and the version retrieval method has been updated to ensure accurate version identification and upgrade prompts. Overall, these enhancements aim to improve user experience and operational clarity. + - [v11.3.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.3.3) - Version 11.3 introduces several user-impacting changes aimed at improving the Azure DevOps Migration Tools experience. Notably, the migration context has been updated to retrieve project information from target work items, which may alter project migration configurations. Documentation enhancements include improved clarity in warnings, support for migrating between different language versions (specifically German to English), and a simplified configuration design. Additionally, the expected processor count in configuration tests has been adjusted, and query parameters have been renamed to better align with Work Item Query Language (WIQL), accompanied by new examples to aid users in crafting queries. + - [v11.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.2.1) - Version 11.2 introduces significant user-impacting changes, including enhancements to migration tools and work item management. In version 11.2.0, a new configuration option, "WorkItemDeleteConfig," allows users to control the deletion of work items based on specific queries, while the migration client has been refactored for improved efficiency in handling work item data. Version 11.2.1 further streamlines the migration process by integrating node structure migration into the updated `WorkItemMigrationConfig`, replacing the deprecated `NodeStructuresMigrationConfig`. Users can now specify `NodeBasePaths` directly within the migration configuration, and comprehensive documentation updates ensure that users have access to the latest configuration options. + - [v11.12.23](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.12.23) - Version 11.12.23 introduces a significant enhancement with the addition of a new boolean parameter, `PrefixProjectToNodes`, in the `FixAreaPathAndIterationPathForTargetQuery` method, allowing users to control the inclusion of the project name in area path constructions during work item migration. This update is supported by multiple test cases to ensure accurate functionality. Additionally, previous versions have seen improvements in identity refresh processes, enhanced logging for better visibility, and new configuration options for migrating team member capacities and handling embedded images, all aimed at streamlining the migration experience and providing users with greater control and clarity throughout the process. + - [v11.11.27](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.11.27) - Version 11.11 introduces a range of user-impacting changes aimed at enhancing the Azure DevOps Migration Tools. Key features include the addition of a `YamlFilename` property in the `BuildDefinitions.cs` file, a new GitHub Actions workflow for project building and testing, and improved handling of work item queries through a factory for query builders. Users will benefit from enhanced flexibility with nullable boolean values in configuration options, the ability to filter test plans by area path, and new methods for retrieving pipeline definitions. Additionally, logging improvements provide clearer error messages, while various bug fixes and updates to package references enhance overall functionality and compatibility. + - [v11.10.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.10.1) - Version 11.10 introduces significant user-impacting changes, including a new feature that allows users to limit the number of revisions migrated in the WorkItemMigration processor through the `MaxRevisions` option, enhancing control over migration processes. Additionally, version 11.10.1 improves error logging and debugging for the TfsWorkItemLinkEnricher, particularly in handling related links, providing more detailed log messages for various scenarios. However, users should note that a section related to revision limits in the TfsRevisionManager has been commented out, which may affect how revisions are processed and reported. + - [v11.1.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.1.4) - Version 11.1 introduces several user-impacting changes aimed at enhancing flexibility and improving service management during migration processes. Key updates include the ability to conditionally register hosted services based on command-line arguments in version 11.1.4, allowing users to choose between initializing or executing services directly. Version 11.1.3 shifts the service registration for IMigrationClient from singleton to transient, affecting how services are instantiated. Additionally, version 11.1.2 features a renaming of the `MigrationOMClient` to `MigrationClient`, along with the introduction of the `IWorkItemMigrationClient` interface and a new `WorkItemMigrationClient` class, which enhance work item management capabilities. The overall structure has been refined to improve query handling and retrieval of work items. Other improvements include enhanced configuration handling in version 11.1.1 and updates to configuration files in version 11.1.0, ensuring a more consistent and user-friendly experience across the application. + - [v11.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.0.2) - Version 11.0 introduces significant user-impacting changes, including a shift in project naming from "VstsSyncMigrator" to "MigrationTools," enhancing clarity for Azure DevOps and File System clients. The update streamlines configuration options and removes obsolete projects, improving usability for developers. Additionally, error handling in migration operations has been enhanced, providing better logging and exception management. The introduction of C# 9.0 support and new project references further optimizes the application's performance and configuration management, ensuring a smoother user experience. +- [v10.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - The latest updates to the Migration Tools suite introduce a range of impactful enhancements for users. New projects, such as "MigrationTools.Sinks.AzureDevOps," have been added, along with a revamped console UI for improved Azure DevOps integration. Configuration management has been enhanced, allowing for easier JSON file loading and new telemetry settings. The migration engine has been optimized for better work item handling, and logging has been clarified. Users will need to update their configuration files due to a namespace change and new parameters for work item migration. Subsequent updates further simplify the configuration process, improve field mapping options, and enhance documentation for migrating test artifacts. Overall, these changes provide users with greater flexibility, control, and usability in their migration tasks. + - [v10.2.13](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - Version 10.2 introduces significant user-impacting changes, including enhanced documentation for migrating test artifacts and work item types, and the addition of new consultants for support. Key improvements include the renaming of the `IWorkItemSink` interface to `IWorkItemMigrationSink`, new field mapping classes for better migration flexibility, and updates to logging capabilities with the introduction of an `ITelemetryLogger` interface. Users will benefit from improved error handling in logging, enhanced configuration options, and a more organized project structure. Additionally, minor documentation corrections and formatting updates enhance overall usability and clarity. + - [v10.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.1.1) - Version 10.1 introduces significant user-impacting changes aimed at enhancing the configuration experience. The design has been simplified to require only the class Name instead of the FullName, streamlining the setup process. Additionally, the ObjectType field has been updated to remove unnecessary prefixes, making it more user-friendly. Users will also benefit from updated configuration examples that incorporate new source and target project settings, including the addition of a Personal Access Token and various new field mapping options, which provide greater customization during migration tasks. + - [v10.0.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.0.10) - Version 10.0 of the Migration Tools suite brings significant user-impacting changes, including the introduction of new projects like "MigrationTools.Sinks.AzureDevOps" and enhancements to the console UI for better integration with Azure DevOps. Users will benefit from improved configuration management, allowing for JSON file loading and new settings for telemetry and application insights. The migration engine has been streamlined with new interfaces for better work item handling, while logging has been enhanced for clarity. Additionally, users must update their configuration files due to a namespace change and the introduction of new parameters for work item migration, ensuring greater flexibility and control in their migration processes. +- [v9.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - The latest major release brings a host of user-focused enhancements and improvements. Key features include multi-language support for Azure DevOps migrations, allowing for greater flexibility in handling different language versions. Users will benefit from improved configuration documentation, which now includes new fields for language mapping of Area and Iteration paths. Subsequent updates have introduced customizable field mappings, conditional logic for excluding specific work item types, and enhanced error handling for better troubleshooting. Additionally, logging capabilities have been significantly upgraded, providing more structured output and insights into application performance. Overall, these changes aim to streamline the migration process and improve user experience. + - [v9.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - Version 9.3 introduces significant enhancements, including an upgrade of the Microsoft.ApplicationInsights library to version 2.12.0, which improves application performance monitoring. The addition of Serilog enhances logging capabilities, providing users with more structured and detailed logging output. Furthermore, the update includes improved error handling and logging practices, transitioning from traditional trace logging to Serilog's framework, which may require users to adjust their log configuration and viewing methods. Overall, these changes aim to enhance user experience through better performance insights and more effective logging. + - [v9.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.2.0) - Version 9.2.0, released on August 21, 2020, introduces significant user-impacting changes, including an update to the configuration documentation that renames the key "LanguageMap" to "LanguageMaps" and corrects the mapping for "AreaPath" to "IterationPath," enhancing clarity in the configuration structure. Furthermore, error handling in the WorkItemQueryMigrationContext has been improved, offering more detailed logging of source and target queries during save failures, which will assist users in troubleshooting issues more effectively. + - [v9.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.1.1) - Version 9.1 introduces significant enhancements to the migration process, focusing on user experience and flexibility. The new configuration option in version 9.1.0 allows users to define SourceToTargetFieldMappings, improving the customization of field mappings during migrations. Additionally, version 9.1.1 enhances the WorkItemMigrationContext class by implementing conditional logic to exclude "Test Plan" and "Test Suite" work item types from certain migrations, ensuring better handling of work item revisions and metrics. This update also improves the management of work item states and includes better logging for unsupported types, providing users with clearer insights during the migration process. + - [v9.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.0.1) - Version 9.0 introduces significant user-impacting changes, including the addition of multi-language support for migrating between different language versions of Azure DevOps, enhancing user flexibility. The configuration documentation has been improved to include new fields for language mapping of Area and Iteration paths, allowing users to specify these mappings for both source and target projects. Additionally, version 9.0.1 brings a new funding configuration file, deprecates the `doneMatch` property in the `FieldMergeMapConfig` class, improves error handling to prevent matching source and target fields, and enhances merging logic for better field updates. Users will also notice a change in the URI for the getting started guide in the extension's configuration. +- [v8.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - The latest major release introduces a range of impactful enhancements and features designed to improve user experience and streamline migration processes. Users can now take advantage of enhanced configuration options, including custom paths for configuration files and new modes for the `init` command. The migration process has been significantly refined with improved error handling, better logging, and new parameters for managing attachments and links. Notable features include the ability to sync changes post-migration, retry failed work item saves, and customize attachment handling. Additionally, the rebranding of the tool ensures users have access to accurate documentation and resources. Overall, these updates focus on providing greater control, efficiency, and clarity throughout the migration experience. + - [v8.9.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - Version 8.9 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notably, version 8.9.10 modifies the method for finding reflected work items, requiring integer conversion for query IDs, and adds null checks for target plans, which may affect test suite management. Version 8.9.9 brings new configuration options to address migration errors and updates documentation for better clarity. Additionally, version 8.9.6 introduces structured issue templates for GitHub, facilitating user interaction for reporting bugs and suggesting features. The release also includes updates to support resources, streamlining migration processes, and enhancing code clarity through refactoring and the introduction of a new `.editorconfig` file. Overall, these updates aim to improve usability and streamline operations for users of the Azure DevOps Migration Tools. + - [v8.8.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.8.0) - Version 8.8.0, released on February 21, 2020, introduces significant user-impacting changes aimed at enhancing migration processes. A new configuration option, `SkipToFinalRevisedWorkItemType`, allows users to seamlessly migrate work items by adopting the most recent revision's work item type when a type change is detected, particularly beneficial for migrations from Azure DevOps Service to Azure DevOps Server. Additionally, the `FilterWorkItemsThatAlreadyExistInTarget` option has been improved to boost migration efficiency by excluding work items that have already been migrated, streamlining the overall process for users. + - [v8.7.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.7.3) - Version 8.7 introduces several user-impacting changes aimed at enhancing the migration process and improving configuration management. Key features include a new GitHub Actions workflow for nightly merges, support for Personal Access Tokens in work item migration, and new settings for attachment migration, which allow users to customize attachment handling more effectively. Additionally, the configuration documentation has been updated to reflect these changes, including a new executable name and command options for initializing configuration files. The updates also refine the handling of work item and test point assignments during migration, ensuring a smoother user experience. + - [v8.6.9](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.6.9) - Version 8.6 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and fixes. Key features include improved handling of work item attachments and links, enhanced link validation for Git commit and pull request IDs, and refined project prefixing logic during team migrations. Users will benefit from a new Visual Studio Code task configuration for building projects, as well as updated documentation for changeset migration and cross-project linking. Additionally, the release addresses various bugs, such as ensuring only valid external links are processed and enhancing version management reliability. Users should note the removal of certain project files, which may require configuration adjustments. + - [v8.5.5](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.5.5) - Version 8.5 of the Azure DevOps Migration Tools introduces significant user-impacting changes, including a rebranding from "vsts-sync-migrator" to "azure-devops-migration-tools," ensuring users have accurate documentation and resources. Enhancements to repository querying capabilities allow for improved traceability and error handling during migrations, while validation checks for work item fields bolster data integrity. The update also modifies cross-project linking behavior, potentially affecting work item queries. Additionally, new configuration options for work item migration, such as attachment management and migration control features, provide users with greater flexibility and efficiency in their migration processes. + - [v8.4.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.4.7) - Version 8.4 introduces significant user-impacting changes, including new configuration options such as `WorkItemCreateRetryLimit` for retrying failed work item saves and `FilterWorkItemsThatAlreadyExistInTarget` to streamline the migration process. The GitHub Actions workflow for managing stale issues and pull requests has been enhanced, now running daily and allowing exemptions for 'enhancement' labeled items. Additionally, the migration engine's console title now displays project names, and the project naming conventions have been updated for better clarity. Other improvements include refined tag handling and adjustments to SQL query formatting for enhanced readability. Overall, these updates aim to improve user experience and efficiency in project management and migration tasks. + - [v8.3.8](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.3.8) - Version 8.3 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and fixes. Key features include the ability to sync changes post-migration and restart migrations at the revision level, significantly improving the migration process. The documentation has been enhanced for better user guidance, with clearer setup instructions and the addition of a new consultant for paid support options. Notable updates to package references enhance compatibility and performance, while minor corrections in the README and documentation ensure clarity in support information. Overall, this release focuses on improving user experience and streamlining migration processes. + - [v8.2.6](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.2.6) - Version 8.2 introduces several user-impacting changes aimed at enhancing the migration process. Key features include the new `GitRepoMapping` configuration option for defining source and target Git repository mappings, and improved error messaging for configuration mismatches. Users can now pause the migration after each work item for confirmation, and optional parameters have been added for saving work items and processing attachments. Enhancements in logging provide better insights into the migration process, while the restructuring of the `TestPlansAndSuitesMigrationContext` class improves metrics tracking and telemetry. Additionally, the assembly title has been updated to "Azure DevOps Migration Tools," which may affect localization interactions. Overall, these updates aim to streamline the migration experience and improve user control and visibility. + - [v8.1.9](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.1.9) - Version 8.1 of the Azure DevOps Migration Tools introduces several user-impacting changes aimed at enhancing functionality and user experience. Key updates include improved visibility with the console title now displaying the configuration file name and version, as well as new configuration options for querying work items, allowing for more flexible retrieval. Users will benefit from enhanced error handling during work item retrieval, better telemetry tracking for migration performance, and new parameters for team migration settings. Additionally, the versioning system has been refined to prevent compatibility issues, and users are now warned of configuration mismatches. Overall, these updates provide users with greater control, stability, and insights during the migration process. + - [v8.0.17](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.0.17) - Version 8.0 introduces significant user-impacting changes, including enhanced configuration options for the `init` command, allowing users to specify custom configuration file paths and choose between `Full` and `WorkItemTracking` modes. The migration process has been improved with new parameters for handling attachments and links, as well as options for retrying failed work item creations. Users will benefit from updated documentation paths and improved error handling during attachment processing. Additionally, the removal of certain configuration options may affect users relying on those features, while new command-line options for TFS instance credentials enhance security and flexibility. Overall, these updates aim to improve the migration experience and streamline user interactions with the tool. +- [v7.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - The latest major release brings a host of user-focused enhancements and features designed to improve performance and usability. Key updates include a framework upgrade that boosts application performance and compatibility, alongside dependency updates for improved functionality and security. New configuration options allow for greater flexibility during data migration, including filtering elements by tags and replaying work item revisions. Enhancements to error handling and logging, as well as improvements in attachment management, contribute to a more reliable user experience. Additionally, the introduction of online status checks for version updates ensures users stay informed about the latest changes while connected to the internet. + - [7.5.74](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - Version 7.5 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and features aimed at improving the migration experience. Key updates include the addition of new configuration options such as `ReplayRevisions`, `FieldtoFieldMultiMap`, and `TestPlanQueryBit`, which enhance flexibility in data migration and allow for more customized setups. The documentation has been significantly improved to provide clearer guidance on these new features and configuration requirements. Additionally, various bug fixes and performance optimizations have been implemented, including better error handling, improved logging, and refined attachment management processes, ensuring a more reliable and user-friendly migration experience. + - [7.4.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.4.2) - Version 7.4 introduces several user-impacting changes across its updates. In version 7.4.0, enhancements to the `FieldValuetoTagMap` class improve tag processing and display through better regular expression matching and formatting options. Version 7.4.1 adds a Contributor Covenant Code of Conduct to foster a respectful community, updates contributing guidelines for easier issue submissions, and upgrades key dependencies like Newtonsoft.Json and Microsoft.ApplicationInsights. Finally, version 7.4.2 improves the attachment download process by replacing the `WebClient` with a more efficient method from `WorkItemServer`, along with enhanced error logging for clearer exception messages. + - [7.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.2.0) - Version 7.2.0, released on August 1, 2017, introduces several user-impacting enhancements, particularly for the VSTS Sync Migration Tools. Key updates include an updated `next-version` in the `GitVersion.yml` file, now reflecting version 7.2.0, and improvements to the `vss-extension.json` file, which now features a repository link and updated support links. Users can continue to enjoy the same robust functionality for bulk editing and migrating work items in TFS and VSTS, ensuring a seamless experience with the latest version. + - [7.1.8](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.1.8) - Version 7.1 introduces several user-impacting changes, including the addition of a new configuration option, `OnlyElementsWithTag`, which allows users to filter elements during migration based on specified tags. The `FixGitCommitLinks` processor has been enhanced to support specifying a `TargetRepository`, improving flexibility in link fixing. Additionally, the `WorkItemRevisionReplayMigrationConfig` now enables users to replay all revisions of work items during migration. The release also includes updates to configuration files for better XML formatting and consistent assembly binding redirects, along with improvements in handling work item fields, ensuring a more streamlined and efficient user experience. + - [7.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.0.2) - Version 7.0 introduces several user-impacting changes, including a significant upgrade to the target framework from v4.5 to v4.6.2, enhancing overall application performance and compatibility. The update also includes dependency upgrades, notably `Newtonsoft.Json` to version 9.0.1 and `Microsoft.ApplicationInsights` to version 2.2.0, which may improve functionality and security. Subsequent releases, 7.0.1 and 7.0.2, further refine the user experience by implementing an online status check for version updates in the `VstsSyncMigrator.Console` application, ensuring users receive timely notifications only when connected to the internet. Additionally, version 7.0.2 comments out the conditional trace listener initialization in the telemetry logging, which may alter how telemetry data is captured during application execution. +- [v6.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - The latest major release brings a host of impactful changes for users. A key highlight is the rebranding of the command-line tool to `vstssyncmigrator`, accompanied by updated documentation to assist with the new command structure. Enhancements to attachment export and import migration contexts improve ID formatting, while the restructuring of project organization may necessitate updates to project references. Users will also benefit from improved global configuration documentation, with various processors now enabled by default for immediate functionality. New features include the `WorkItemQueryMigrationContext`, allowing for selective migration of work item queries, and the option to prefix project names in folder paths for better organization. Enhanced logging and an updated FAQ section further support users in managing their migration processes effectively. + - [6.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - Version 6.3 introduces several user-impacting changes, including enhanced logging in the console application that notifies users of the current and latest available versions, encouraging timely upgrades. The release also features an updated FAQ section that clarifies the consistency requirement for the `PrefixProjectToNodes` setting and addresses potential migration errors. Additionally, improvements in documentation emphasize the need for users to customize their configuration files and ensure that processors are enabled for optimal functionality. + - [6.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.2.0) - Version 6.2.0 introduces significant user-impacting changes, including an updated `next-version` in the GitVersion configuration, now set to 6.2.0. A notable new feature is the `WorkItemQueryMigrationContext`, accompanied by the `WorkItemQueryMigrationConfig` class, which empowers users to enable or disable the migration of work item queries. Additionally, users can now choose to prefix project names in folder paths, providing enhanced flexibility and control over migration options. + - [6.1.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.1.0) - Version 6.1.0, released on January 24, 2017, brings significant user-impacting changes, including an update to the global configuration documentation for improved clarity on structure and options. A key enhancement is the change in the default state of various processors to enabled, allowing users to utilize functionality immediately upon configuration. The command-line documentation has also been improved to stress the importance of enabling processors for execution. Furthermore, this release includes enhancements in link migration handling and test plans, which provide better traceability and error management during the migration process. + - [6.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.0.2) - Version 6.0 introduces significant user-impacting changes, including a complete rebranding of the command-line tool from `vsts-sm` to `vstssyncmigrator`, which is reflected in updated documentation to guide users on the correct commands for setup and execution. The versioning has been updated in the GitVersion configuration, and the Chocolatey installation script has been modified to accommodate the new package name. Additionally, the release includes adjustments to attachment export and import migration contexts, enhancing the formatting of reflected IDs. Users should also note the restructuring of project organization, with various classes and namespaces renamed, which may require updates in their project references. +- [v5.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - The latest major release brings a host of impactful changes designed to enhance user experience and functionality. Key updates include a rebranding to "VSTS Sync Migration Tools" and a simplified command name for installation and uninstallation. Users can now benefit from the new `MultiValueConditionalMapConfig` class, which allows for more complex field mapping configurations. Version 5.1 introduces customizable user preferences and improved command-line functionality, while 5.3 enhances the migration process for test plans with a new method for handling test cases, updates to installation scripts for better package verification, and optimizations in field merging. Comprehensive new documentation supports these changes, ensuring users can easily adapt to the updated features and configurations. + - [5.3.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - Version 5.3 introduces several user-impacting changes, including the addition of a new method, `ProcessChildTestCases`, in the `TestPlansAndSuitsMigrationContext` class, which streamlines the migration process for test plans and suites by enabling the handling of test cases. The release also updates the GitVersion configuration to reflect the new version, enhances Chocolatey installation scripts with a checksum for improved package verification, and introduces a `doneMatch` property in the field mapping configuration to optimize field merging by preventing the reprocessing of already merged fields. Additionally, new documentation has been provided to facilitate user onboarding. + - [5.1.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.1.0) - Version 5.1.0, released on October 19, 2016, brings significant user-impacting changes, including new configuration options that allow for greater customization of user preferences. Enhancements to existing command-line flags improve functionality, making it easier for users to execute commands efficiently. Additionally, adjustments to default settings have been made to streamline the overall user experience, ensuring a more intuitive interaction with the software. + - [5.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.0.1) - Version 5.0 introduces significant user-impacting changes, including a rebranding from "VSTS Bulk Data Editor & Migrator" to "VSTS Sync Migration Tools" and a streamlined command name change from `vstssyncmigration` to `vsts-sm` for installation and uninstallation. The update also features the new `MultiValueConditionalMapConfig` class, which enhances field mapping flexibility by allowing complex configurations with multiple source and target field values. Additionally, comprehensive new documentation has been provided to assist users with configuration and usage, reflecting updated command structures and new options for processing work items and links. +- [v4.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - The latest major release introduces a range of impactful enhancements aimed at improving user experience and flexibility during work item migration. A key feature is the new configuration option, `PrefixProjectToNodes`, which allows users to customize the prefixing of project names to area and iteration paths, as well as nodes, enhancing project structure management. The migration logic has been updated to support these options, streamlining the migration process. Additionally, users will benefit from improved documentation, including clearer installation instructions and new JSON configuration files. The release also includes an uninstall script for easier tool management and enhancements to caching and field exclusion during migrations, further refining the overall functionality. + - [4.4.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - Version 4.4.0, released on October 18, 2016, brings significant user-facing enhancements, including updated README and documentation that clarify installation options for the VSTS Bulk Data Editor Engine. Users can now choose from recommended methods such as installing via Chocolatey, downloading the latest release from GitHub, or creating custom tools using the NuGet package. Additionally, the `FindReflectedWorkItem` method has been improved with a new caching option, and an ignore list feature has been introduced to allow users to exclude specific fields during work item migration, enhancing overall functionality and user experience. + - [4.3.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.3.0) - Version 4.3.0 introduces several user-impacting changes, including an updated `next-version` in the GitVersion configuration, now set to 4.2.0. A new uninstall script for the VSTS Sync Migration tool has been added, enhancing user experience during tool management. The package metadata has been improved with a new ID format and the inclusion of an icon URL. Additionally, users will benefit from new JSON configuration files in the documentation, which now offers clearer instructions for obtaining the tools, with a strong recommendation for installation via Chocolatey. + - [4.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.2.0) - Version 4.2.0, released on October 12, 2016, introduces significant user-impacting changes, including the addition of a Chocolatey package for the VSTS Sync Migrator, complete with a PowerShell installation script and nuspec file for streamlined installation and management. Furthermore, the update enhances the Test Plans and Suits migration configuration by introducing a new option, `PrefixProjectToNodes`, enabling users to customize how project names are prefixed during the migration process. + - [4.1.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.1.0.2) - Version 4.1 introduces significant user-impacting changes aimed at enhancing migration workflows. The update includes a new configuration option, `PrefixProjectToNodes`, in the `NodeStructuresMigrationConfig` class, allowing users to choose whether project names should be prefixed to nodes during migration, thereby increasing flexibility in node structure processing. Additionally, the migration context has been improved to utilize this new option. Furthermore, the update enhances the WorkItemMigrationContext by replacing hardcoded project names for AreaPath and IterationPath with dynamic references to the new work item's project name, further streamlining project migration configurations. Lastly, the project and license URLs in the `.nuspec` file have been updated to reflect the new repository location. + - [4.0.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.0.0.2) - Version 4.0.0.2 introduces a significant enhancement with the new configuration option, `PrefixProjectToNodes`, in the `WorkItemMigrationConfig` class. This feature allows users to customize whether the project name is prefixed to area and iteration paths during work item migration, providing greater flexibility in managing project structures. Additionally, the migration logic has been updated to support this new option, ensuring that area and iteration paths are constructed according to the user's preferences. +- [v3.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - The latest updates bring a host of enhancements designed to improve user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for tailored migration processes, and the introduction of classes for managing team settings. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The migration process has been streamlined with improved telemetry tracking and error handling, while new documentation provides valuable context and guidance. Significant improvements to the TfsWitMigrator tool enhance work item tagging flexibility, and updates to the migration context for test plans and variables offer greater control during migrations. Overall, these changes aim to make data migration more efficient and user-friendly. + - [3.6.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - Version 3.6.0.1 introduces significant enhancements to the migration process, particularly for test plans and variables. Notably, the `TestPlansAndSuitsMigrationContext` now includes logic to conditionally set the `AreaPath` and `Iteration` properties based on configuration values, providing users with greater flexibility during migrations. Additionally, the `TestVeriablesMigrationContext` has been improved to automatically create new test variables and their allowed values if they do not already exist, streamlining the management of test variables. These updates aim to enhance user experience and efficiency in migration tasks. + - [3.5.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.5.0.2) - Version 3.5.0.2 introduces significant enhancements to the Visual Studio Team Services Bulk Data Editor Engine, focusing on improved user experience and functionality. The documentation has been updated to clarify the capabilities of various mapping tools and processors, now featuring new field mapping options like FieldMergeMap and FieldBlankMap. Additionally, enhancements to the WorkItemUpdate and WorkItemDelete processors offer users greater flexibility and control during data migration and updates, making the process more efficient and user-friendly. + - [3.4.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.4.1.1) - Version 3.4 introduces significant user-impacting changes, including the release of version 3.4.1.1, which adds a new configuration option for mapping field values to tags in the TfsWitMigrator tool. This enhancement allows users to define a source field, a matching pattern, and a format expression for tag creation, greatly improving the flexibility of work item tagging. Additionally, version 3.4.0.2 includes a minor update to the Telemetry.cs file, adding a comment for clarity without affecting the functionality of the telemetry initialization process. + - [3.3.0.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.3.0.4) - Version 3.3 introduces significant user-impacting changes, including the public accessibility of the `Program` class, which broadens user interaction capabilities. Enhancements to the TfsWitMigrator feature a new configuration option for fixing Git commit links, allowing users to specify query conditions for link migrations. The Application Insights configuration has been improved to include performance monitoring modules, and telemetry events now track unhandled exceptions, enhancing error reporting. Additionally, the introduction of unit tests for the `EngineConfiguration` and `MigrationEngine` classes strengthens the testing framework, while new configuration files ensure proper assembly binding and dependencies, particularly for Newtonsoft.Json. + - [3.2.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.2.3.1) - Version 3.2 introduces several user-impacting changes, including the addition of a new documentation page titled "Why," which provides users with enhanced context and links to further information. Additionally, the VSTS Bulk Data Editor & Migrator has undergone significant improvements, requiring users to create a new `vstsbulkeditor.yml` file for defining migration settings. This update includes comprehensive documentation on configuration options, command-line usage instructions, and a NuGet package for advanced users, alongside enhancements in error handling and the migration process for test plans and suites. + - [3.1.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.1.0.2) - Version 3.1.0.2 introduces a new configuration option, `AreaIterationPath`, to the `TestPlansAndSuitsMigrationConfig` class, significantly enhancing the flexibility of migration settings for users. Additionally, improvements have been made to trace logging, with the inclusion of a consistent identifier, "vstsbulkeditor," which enhances the clarity of log outputs during execution and migration processes. These updates aim to improve user experience and streamline migration workflows. + - [3.0.0.41](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.0.0.41) - Version 3.0 introduces several impactful changes aimed at enhancing user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for customized migration processes, and the introduction of classes for team migration, which facilitate team settings management. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The update also streamlines work item saving processes, improves telemetry tracking for better monitoring, and enhances error tracking capabilities. Notably, the assembly versioning scheme has been updated, and various configuration options have been added or improved, providing users with greater control and flexibility in their migration tasks. +- [v0.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - The latest update brings a range of enhancements designed to improve user experience. Users will benefit from increased performance and stability, alongside new features that simplify interactions. Additionally, numerous bugs identified in earlier releases have been resolved, contributing to a more seamless and dependable operation. This update focuses on creating a more efficient and user-friendly environment for all. + - [0.5.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - Version 0.5.1 introduces several user-impacting changes, including new features, improvements, and bug fixes. Users can expect enhanced performance and stability, along with the addition of new functionalities that streamline their experience. This update also addresses various bugs reported in previous versions, ensuring a smoother and more reliable operation. Overall, version 0.5.1 aims to provide a more efficient and user-friendly environment.