Skip to content

Commit 0f07430

Browse files
authored
📝 docs(README): update links and installation instructions (#2844)
- remove outdated badge from README - update documentation links to devopsmigration.io - add detailed installation and support information
2 parents ff7ef0b + 5d1340d commit 0f07430

File tree

1 file changed

+10
-13
lines changed

1 file changed

+10
-13
lines changed

src/MigrationTools.Extension/README.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Azure DevOps Migration Tools [![GitHub release](https://img.shields.io/github/v/release/nkdAgility/azure-devops-migration-tools)](https://github.com/nkdAgility/azure-devops-migration-tools/releases) ![Build on VSTS](https://nkdagility.visualstudio.com/_apis/public/build/definitions/1b52ce63-eccc-41c8-88f9-ae6ebeefdc63/94/badge)
1+
# Azure DevOps Migration Tools [![GitHub release](https://img.shields.io/github/v/release/nkdAgility/azure-devops-migration-tools)](https://github.com/nkdAgility/azure-devops-migration-tools/releases)
22

3-
The Azure DevOps Migration Tools allow you to bulk edit and migrate data between Team Projects on both Microsoft Team Foundation Server (TFS) and Azure DevOps Services. Take a look at the [documentation](https://nkdagility.com/docs/azure-devops-migration-tools/) to find out how. This project is published as [code on GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/) as well as a Winget package a `nkdAgility.AzureDevOpsMigrationTools`.
3+
The Azure DevOps Migration Tools allow you to bulk edit and migrate data between Team Projects on both Microsoft Team Foundation Server (TFS) and Azure DevOps Services. Take a look at the [documentation](https://devopsmigration.io/) to find out how. This project is published as [code on GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/) as well as a Winget package a `nkdAgility.AzureDevOpsMigrationTools`.
44

55
**Ask Questions on Github: https://github.com/nkdAgility/azure-devops-migration-tools/discussions**
66

@@ -23,7 +23,7 @@ The Azure DevOps Migration Tools allow you to bulk edit and migrate data between
2323
- Bulk edit of `Work Items` accross an entire `Project`.
2424

2525
**WARNING: This tool is not designed for a novice. This tool was developed to support the scenarios below, and the edge cases that have been encountered by the 30+ contributors from around the Azure DevOps community. You should be comfortable with the TFS/Azure DevOps object model, as well as debugging code in Visual Studio.**
26-
**Community support is available through [GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/discussions) ; Paid support is available through our [recommended consultants](https://nkdagility.com/docs/azure-devops-migration-tools/#support) as well as our contributors and many DevOps consultants around the world.**
26+
**Community support is available through [GitHub](https://github.com/nkdAgility/azure-devops-migration-tools/discussions) ; Paid support is available through our [recommended consultants](https://devopsmigration.io/support) as well as our contributors and many DevOps consultants around the world.**
2727

2828
### What versions of Azure DevOps & TFS do you support?
2929

@@ -47,27 +47,24 @@ The Azure DevOps Migration Tools allow you to bulk edit and migrate data between
4747
## Quick Links
4848

4949
- [Video Overview](https://www.youtube.com/watch?v=RCJsST0xBCE)
50-
- [Getting Started](https://devopsmigration.io/getting-started.html)
51-
- [Documentation](https://nkdagility.com/docs/azure-devops-migration-tools/)
50+
- [Getting Started](https://devopsmigration.io/)
51+
- [Documentation](https://devopsmigration.io/docs)
5252
- [Questions on Usage](https://stackoverflow.com/questions/tagged/azure-devops-migration-tools)
5353
- [Bugs and New Features](https://github.com/nkdAgility/azure-devops-migration-tools)
5454

5555
## Installing an running the tools
5656

57-
We use [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/) to host the tools, and you can use the command `winget install nkdAgility.AzureDevOpsMigrationTools` to install them on Windows 10 and Windows 11. For other operating systems you can download the [latest release](https://github.com/nkdAgility/azure-devops-migration-tools/releases/latest) and unzip it to a folder of your choice.
57+
Head over to the [Installing Azure DevOps Migration Tools](https://devopsmigration.io/docs/setup/installation/) documentation to find out how to install and run the tools. We have options for Winget, Chocolatey, and manual installation.
5858

59-
The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devopsmigration.exe` that lets you run it from anywhere using `devopsmigration init`.
60-
61-
For a more detailed getting started guide please see the [documentation](https://nkdagility.com/docs/azure-devops-migration-tools/getting-started.html).
59+
We have a [Tutorial: Get started with the Azure DevOps Migration Tools](https://devopsmigration.io/docs/get-started/getting-started/) for those new to the tooling and wanting to get started quickly.
6260

6361
## Support
6462

65-
1. [Question & Discussion](https://github.com/nkdAgility/azure-devops-migration-tools/discussions) - The first place to look for unsage, configuration, and general help.
66-
1. [Issues on Gitbub](https://github.com/nkdAgility/azure-devops-migration-tools/issues) - If you have identified a bug and have logs then please raise an issue.
63+
Free [community support](https://devopsmigration.io/support) is available as well as [paid support](https://devopsmigration.io/support) from our recommended consultants.
6764

68-
### Professional Support
65+
This tool was create by [Martin Hinshelwood](https://www.linkedin.com/in/martinhinshelwood/) and is maintained by [naked Agility](https://nkdagility.com) with the help of many contributors from the community. We are a small team of Azure DevOps experts that have been working with TFS and Azure DevOps for over 20 years, and we are passionate about helping you get the most out of your Azure DevOps instance.
6966

70-
You can get free support from the community above and on social media on a best effort basis if folks are available. If you are *looking for paid support* [naked Agility with Martin Hinshelwood & Co](https://nkdagility.com) has a number of experts, many of whom contribute to this project, that can help. Find out how [we can help you](https://nkdagility.com/technical-consulting-and-coaching/azure-devops-migration-tools-consulting/) with your migration and [book a free consultation](https://nkdagility.com/technical-consulting-and-coaching/azure-devops-migration-tools-consulting/) to discuss how we can make things easyer.
67+
We do also provide [comprehensive migration services](https://nkdagility.com/capabilities/azure-devops-migration-services/) for enterprises. Find out how [we can help you](https://nkdagility.com/capabilities/azure-devops-migration-services/) with your migration and [book a free consultation](https://nkdagility.com/capabilities/azure-devops-migration-services/) to discuss how we can make things easer.
7168

7269
We use these tools with our customers, and for fun, to do real world migrations on a daily basis and we can:
7370

0 commit comments

Comments
 (0)