From 1c4c0fb9794f04c27a2c6c040639c94fa196212f Mon Sep 17 00:00:00 2001 From: Chet Husk Date: Tue, 13 Dec 2022 16:35:14 -0600 Subject: [PATCH 1/2] add release instructions for the uninstall tool --- src/dotnet-core-uninstall/README.md | 49 +++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 src/dotnet-core-uninstall/README.md diff --git a/src/dotnet-core-uninstall/README.md b/src/dotnet-core-uninstall/README.md new file mode 100644 index 0000000..a6abe50 --- /dev/null +++ b/src/dotnet-core-uninstall/README.md @@ -0,0 +1,49 @@ +# dotnet-core-uninstall + +This project is a standalone uninstaller for Windows and MacOS. It exists partially to ensure that a) it's easy to uninstall the SDK and b) SDKs that are required by various VS versions aren't also uninstalled. + +# Releasing the tool + +To release the tool, you need to do the following: + +* bump the version of the tool in eng/Versions.props +* send a PR with this change and get it merged +* wait for the associated build pipeline in VSTS to complete +* get the version generated from the build pipeline and use it to create a tag in git +* use that tag to create a github release. Add release notes with + * A list of changes from the last release + * The install instructions, which are included below + * The 4 primary assets for the repo: + * Windows MSI from VSTS pipeline + * macOS tar.gz from VSTS pipeline + * Source code (zip) generated by GitHub at time of release creation + * Source code (tar.gz) generated by GitHub at time of release creation + +## Release notes template + +# Changes + + +# Installation Instructions: + +## On Windows: + +1. Download the msi file below. +2. Double click the msi file to install. +3. Open a new command prompt. +4. Check out the docs at https://aka.ms/dotnet-core-uninstall-docs +5. Run the tool by using dotnet-core-uninstall. +6. If you accidentally mess up your Visual Studio installation, use "Repair" in the Visual Studio installer. + +## On macOS: + +Download the tar.gz file below. +Open terminal and change working directory to the directory with dotnet-core-uninstall.tar.gz. +Use the following commands to install the tool and show help: + +```shell +mkdir -p ~/dotnet-core-uninstall +tar -zxf dotnet-core-uninstall.tar.gz -C ~/dotnet-core-uninstall +cd ~/dotnet-core-uninstall +./dotnet-core-uninstall -h +``` From f95609bf743de01a3f2c0a5b82571b45b4d57ea5 Mon Sep 17 00:00:00 2001 From: Chet Husk Date: Tue, 13 Dec 2022 17:48:49 -0600 Subject: [PATCH 2/2] Update src/dotnet-core-uninstall/README.md Co-authored-by: Jacques Eloff --- src/dotnet-core-uninstall/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/dotnet-core-uninstall/README.md b/src/dotnet-core-uninstall/README.md index a6abe50..19b58c5 100644 --- a/src/dotnet-core-uninstall/README.md +++ b/src/dotnet-core-uninstall/README.md @@ -1,6 +1,6 @@ # dotnet-core-uninstall -This project is a standalone uninstaller for Windows and MacOS. It exists partially to ensure that a) it's easy to uninstall the SDK and b) SDKs that are required by various VS versions aren't also uninstalled. +This project is a standalone uninstaller for Windows and MacOS. It exists partially to ensure that a) it's easy to uninstall the SDK and b) SDKs that are required by various VS versions aren't also uninstalled. # Releasing the tool