Improve opening description in README.

Removed the setting of the 'useConfigFile' input in example 2 as the input now has the correct default set.

.editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.yml]
+indent_size = 2
+
+[*.md]
+indent_size = 2

.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+- package-ecosystem: npm
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10

.github/stale.yml

@@ -0,0 +1,18 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 90
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 30
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - pinned
+  - security
+  - bug
+# Label to use when marking an issue as stale
+staleLabel: stale
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. After 30 days from now, it will be closed if no further
+  activity occurs. Thank you for your contributions.
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

.github/workflows/ci.yml

@@ -1,5 +1,12 @@
 name: CI
-on: [push, pull_request]
+on:
+  push:
+    branches:
+    - master
+
+  pull_request:
+    branches:
+    - master
 
 jobs:
   build:
@@ -8,6 +15,7 @@ jobs:
     strategy:
       matrix:
         os: [windows-latest, ubuntu-latest, macos-latest]
+      fail-fast: false
     steps:
     - uses: actions/checkout@v2
     - name: Fetch all history for all tags and branches
@@ -15,13 +23,14 @@ jobs:
         git fetch --prune --unshallow
     - run: |
         npm install
-        npm run build:github 
+        npm run format-check
+        npm run build:github
         npm run build:azure
       name: Build code
     - name: Install GitVersion
       uses: ./gitversion/setup
       with:
-        versionSpec: '5.1.2'
+        versionSpec: '5.x'
     - name: Use GitVersion
       id: gitversion # step id used as reference for output values
       uses: ./gitversion/execute

.github/workflows/release.yml

@@ -17,13 +17,16 @@ jobs:
         git fetch --prune --unshallow
     - run: |
         npm install
-        npm run build:github 
+        npm run build:github
         npm run build:azure
+
+        # npm run compress:github
+        # npm run compress:azure
       name: Build code
     - name: Install GitVersion
       uses: ./gitversion/setup
       with:
-        versionSpec: '5.1.2'
+        versionSpec: '5.x'
     - name: Use GitVersion
       id: gitversion # step id used as reference for output values
       uses: ./gitversion/execute
@@ -32,11 +35,13 @@ jobs:
         $version = "${{steps.gitversion.outputs.majorMinorPatch}}.$date"
         $major = "${{steps.gitversion.outputs.major}}"
         $minor = "${{steps.gitversion.outputs.minor}}"
+        $patch = "${{steps.gitversion.outputs.patch}}"
 
         . .\dist\azure\update-version.ps1
         update-manifest .\dist\azure\vss-extension.json -Version $version
-        dir .\dist\azure\**\task.json | % { update-task $_ -Major $major -Minor $minor }
+        dir -r .\dist\**\task.json | % { update-task $_ -Major $major -Minor $minor -Patch $patch }
 
         npm run publish:azure -- --token ${{ secrets.TFX_TOKEN }}
+
       shell: pwsh
       name: Publish Azure extension

.prettierignore

@@ -0,0 +1,2 @@
+node_modules/
+src/*/node_modules/

.prettierrc.json

@@ -0,0 +1,11 @@
+{
+    "printWidth": 80,
+    "tabWidth": 4,
+    "useTabs": false,
+    "semi": false,
+    "singleQuote": true,
+    "trailingComma": "none",
+    "bracketSpacing": true,
+    "arrowParens": "avoid",
+    "parser": "typescript"
+}

.vscode/launch.json

@@ -9,7 +9,7 @@
             "request": "launch",
             "preLaunchTask": "Build-Mock",
             "name": "Debug Mock Setup GitVersion",
-            "program": "${workspaceFolder}/dist/mock/setup-gitversion/bundle.js",
+            "program": "${workspaceFolder}/dist/mock/gitversion/setup/bundle.js",
             "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
@@ -17,7 +17,7 @@
             "request": "launch",
             "preLaunchTask": "Build-Azure",
             "name": "Debug Azure Setup GitVersion",
-            "program": "${workspaceFolder}/dist/azure/setup-gitversion/bundle.js",
+            "program": "${workspaceFolder}/dist/azure/gitversion/setup/bundle.js",
             "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
@@ -25,7 +25,7 @@
             "request": "launch",
             "preLaunchTask": "Build-GitHub",
             "name": "Debug GitHub Setup GitVersion",
-            "program": "${workspaceFolder}/dist/github/setup-gitversion/bundle.js",
+            "program": "${workspaceFolder}/dist/github/gitversion/setup/bundle.js",
             "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
@@ -33,7 +33,7 @@
             "request": "launch",
             "preLaunchTask": "Build-Mock",
             "name": "Debug Mock Execute GitVersion",
-            "program": "${workspaceFolder}/dist/mock/execute-gitversion/bundle.js",
+            "program": "${workspaceFolder}/dist/mock/gitversion/execute/bundle.js",
             "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
@@ -41,7 +41,7 @@
             "request": "launch",
             "preLaunchTask": "Build-Azure",
             "name": "Debug Azure Execute GitVersion",
-            "program": "${workspaceFolder}/dist/azure/execute-gitversion/bundle.js",
+            "program": "${workspaceFolder}/dist/azure/gitversion/execute/bundle.js",
             "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
@@ -49,7 +49,7 @@
             "request": "launch",
             "preLaunchTask": "Build-GitHub",
             "name": "Debug GitHub Execute GitVersion",
-            "program": "${workspaceFolder}/dist/github/execute-gitversion/bundle.js",
+            "program": "${workspaceFolder}/dist/github/gitversion/execute/bundle.js",
             "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
     ]

README.md

@@ -2,87 +2,28 @@
 
 ![GitTools](docs/icon.png "GitTools")
 
-GitHub Actions that allow to install and use the GitVersion and GitReleaseManager tools
+GitHub Actions that allow the setup and use of the [GitVersion](https://github.com/GitTools/GitVersion) and [GitReleaseManager](https://github.com/GitTools/GitReleaseManager) tools.
 
 [![Build Status](https://github.com/GitTools/actions/workflows/CI/badge.svg)](https://github.com/GitTools/actions/actions)
 [![Build Status](https://github.com/GitTools/actions/workflows/release/badge.svg)](https://github.com/GitTools/actions/actions)
 
+[![GitHub Release](https://img.shields.io/github/v/release/gittools/actions?logo=github&sort=semver)](https://github.com/GitTools/actions/releases/latest)
+
+[![Azure Pipelines Task](https://img.shields.io/badge/marketplace-gittools.gittools-blue?logo=azure-pipelines)](https://marketplace.visualstudio.com/items?itemName=gittools.gittools)
+[![Github Action](https://img.shields.io/badge/marketplace-use--actions-blue?logo=github)](https://github.com/marketplace/actions/gittools)
+
 ## Usage
 
-See [setup](gitversion/setup) and [usage](gitversion/execute/action.yml)
+### GitVersion
 
-## Dependency
+Examples for usage of **GitVersion**:
 
-There are two step dependencies that are required in your workflow before running this action. You must checkout your Git repository and then fetch the master branch and tags.
+- [GitHub Actions](docs/examples/github/gitversion/index.md)
+- [Azure Pipelines tasks](docs/examples/azure/gitversion/index.md)
 
-```yaml
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Fetch all history for all tags and branches
-      run: git fetch --prune --unshallow
-```
+### GitReleaseManager
 
-Basic:
+Examples for usage of **GitReleaseManager**:
 
-```yaml
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Fetch all history for all tags and branches
-      run: git fetch --prune --unshallow
-    - name: Install GitVersion
-      uses: gittools/actions/gitversion/setup@v0.6
-      with:
-          versionSpec: '5.1.x'
-    - name: Use GitVersion
-      id: gitversion # step id used as reference for output values
-      uses: gittools/actions/gitversion/execute@v0.6
-    - run: |
-        echo "Major: ${{ steps.gitversion.outputs.major }}"
-        echo "Minor: ${{ steps.gitversion.outputs.minor }}"
-        echo "Patch: ${{ steps.gitversion.outputs.patch }}"
-        echo "PreReleaseTag: ${{ steps.gitversion.outputs.preReleaseTag }}"
-        echo "PreReleaseTagWithDash: ${{ steps.gitversion.outputs.preReleaseTagWithDash }}"
-        echo "PreReleaseLabel: ${{ steps.gitversion.outputs.preReleaseLabel }}"
-        echo "PreReleaseNumber: ${{ steps.gitversion.outputs.preReleaseNumber }}"
-        echo "WeightedPreReleaseNumber: ${{ steps.gitversion.outputs.weightedPreReleaseNumber }}"
-        echo "BuildMetaData: ${{ steps.gitversion.outputs.buildMetaData }}"
-        echo "BuildMetaDataPadded: ${{ steps.gitversion.outputs.buildMetaDataPadded }}"
-        echo "FullBuildMetaData: ${{ steps.gitversion.outputs.fullBuildMetaData }}"
-        echo "MajorMinorPatch: ${{ steps.gitversion.outputs.majorMinorPatch }}"
-        echo "SemVer: ${{ steps.gitversion.outputs.semVer }}"
-        echo "LegacySemVer: ${{ steps.gitversion.outputs.legacySemVer }}"
-        echo "LegacySemVerPadded: ${{ steps.gitversion.outputs.legacySemVerPadded }}"
-        echo "AssemblySemVer: ${{ steps.gitversion.outputs.assemblySemVer }}"
-        echo "AssemblySemFileVer: ${{ steps.gitversion.outputs.assemblySemFileVer }}"
-        echo "FullSemVer: ${{ steps.gitversion.outputs.fullSemVer }}"
-        echo "InformationalVersion: ${{ steps.gitversion.outputs.informationalVersion }}"
-        echo "BranchName: ${{ steps.gitversion.outputs.branchName }}"
-        echo "Sha: ${{ steps.gitversion.outputs.sha }}"
-        echo "ShortSha: ${{ steps.gitversion.outputs.shortSha }}"
-        echo "NuGetVersionV2: ${{ steps.gitversion.outputs.nuGetVersionV2 }}"
-        echo "NuGetVersion: ${{ steps.gitversion.outputs.nuGetVersion }}"
-        echo "NuGetPreReleaseTagV2: ${{ steps.gitversion.outputs.nuGetPreReleaseTagV2 }}"
-        echo "NuGetPreReleaseTag: ${{ steps.gitversion.outputs.nuGetPreReleaseTag }}"
-        echo "VersionSourceSha: ${{ steps.gitversion.outputs.versionSourceSha }}"
-        echo "CommitsSinceVersionSource: ${{ steps.gitversion.outputs.commitsSinceVersionSource }}"
-        echo "CommitsSinceVersionSourcePadded: ${{ steps.gitversion.outputs.commitsSinceVersionSourcePadded }}"
-        echo "CommitDate: ${{ steps.gitversion.outputs.commitDate }}"
-
-```
-
-### Private Repositories
-
-Private repos require credentials before you can fetch the master branch and tags.  
-
-```yaml
-    steps:
-    - name: Checkout
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Fetch all history for all tags and branches
-      run: |
-        git config remote.origin.url https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}
-        git fetch --prune --unshallow
-```
+- [GitHub Actions](docs/examples/github/gitreleasemanager/index.md)
+- [Azure Pipelines tasks](docs/examples/azure/gitreleasemanager/index.md)

action.yml

@@ -1,18 +1,9 @@
-name: use-actions
-description: GitHub Action for Easy Semantic Versioning with GitVersion. Installs the specific version of GitVersion.Tool
+name: GitTools
+description: Build tasks for easy semantic versioning for projects using Git and release management.
 author: GitTools
 branding:
   color: gray-dark
   icon: git-pull-request
-inputs:
-  versionSpec:
-    description: Required version in the form of 5.x or exact version like 5.0.0
-    required: true
-    default: ''
-  includePrerelease:
-    description: Include pre-release versions when matching a version 
-    required: false
-    default: false
 runs:
   using: node12
   main: dist/github/setup/index.js

dist/azure/gitreleasemanager/addasset/task.json

@@ -0,0 +1,67 @@
+{
+    "id": "b803651c-21ac-4851-9fbf-c75b0e82e4c5",
+    "name": "gitreleasemanager/addasset",
+    "friendlyName": "Add Asset GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/addasset",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "tagName",
+        "type": "string",
+        "label": "The name of the release",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the release"
+    }, {
+        "name": "assets",
+        "type": "multiLine",
+        "label": "Path(s) to the file(s) to include in the release",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "Path(s) to the file(s) to include in the release. Separated by newline"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/close/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "f5304356-f6e3-48e9-9b65-a9efa41ce7a2",
+    "name": "gitreleasemanager/close",
+    "friendlyName": "Close GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/close",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "milestone",
+        "type": "string",
+        "label": "The milestone to use",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The milestone to use"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/create/task.json

@@ -0,0 +1,95 @@
+{
+    "id": "c77d38be-46a9-4ef1-a181-2d6050ed23d2",
+    "name": "gitreleasemanager/create",
+    "friendlyName": "Create GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/create",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "milestone",
+        "type": "string",
+        "label": "The milestone to use",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The milestone to use"
+    }, {
+        "name": "name",
+        "type": "string",
+        "label": "The name of the release",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The name of the release"
+    }, {
+        "name": "inputFilePath",
+        "type": "string",
+        "label": "The path to the file to be used as the content of the release notes",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The path to the file to be used as the content of the release notes"
+    }, {
+        "name": "isPreRelease",
+        "type": "boolean",
+        "label": "Creates the release as a pre-release",
+        "defaultValue": "false",
+        "required": false,
+        "helpMarkDown": "Creates the release as a pre-release"
+    }, {
+        "name": "targetcommitish",
+        "type": "string",
+        "label": "The commit to tag. Can be a branch or SHA. Defaults to repository's default branch",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The commit to tag. Can be a branch or SHA. Defaults to repository's default branch"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }, {
+        "name": "assets",
+        "type": "multiLine",
+        "label": "Path(s) to the file(s) to include in the release",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "Path(s) to the file(s) to include in the release. Separated by newline"
+    }]
+}

dist/azure/gitreleasemanager/discard/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/discard/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "9ae78b66-6100-4522-8106-b7ae00bbfcdf",
+    "name": "gitreleasemanager/discard",
+    "friendlyName": "Discard GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/discard",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "milestone",
+        "type": "string",
+        "label": "The milestone to use",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The milestone to use"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/open/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/open/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "5d437bf5-f193-4449-b531-c4c69eebaa48",
+    "name": "gitreleasemanager/open",
+    "friendlyName": "Open GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/open",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "milestone",
+        "type": "string",
+        "label": "The milestone to use",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The milestone to use"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/publish/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/publish/task.json

@@ -0,0 +1,60 @@
+{
+    "id": "b3c54483-4140-45d8-b442-3a0b096b5f7f",
+    "name": "gitreleasemanager/publish",
+    "friendlyName": "Publish GitReleaseManager Task",
+    "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gittools.github.io/GitReleaseManager/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.115.0",
+    "execution": {
+        "Node": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/publish",
+    "inputs": [{
+        "name": "owner",
+        "type": "string",
+        "label": "The owner of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The owner of the repository"
+    }, {
+        "name": "repository",
+        "type": "string",
+        "label": "The name of the repository",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the repository"
+    }, {
+        "name": "token",
+        "type": "string",
+        "label": "The access token to access GitHub with",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The access token to access GitHub with"
+    }, {
+        "name": "tagName",
+        "type": "string",
+        "label": "The name of the release",
+        "defaultValue": "",
+        "required": true,
+        "helpMarkDown": "The name of the release"
+    }, {
+        "name": "targetDirectory",
+        "type": "string",
+        "label": "The directory on which GitReleaseManager should be executed. Defaults to current directory",
+        "defaultValue": "",
+        "required": false,
+        "helpMarkDown": "The directory on which GitReleaseManager should be executed. Defaults to current directory"
+    }]
+}

dist/azure/gitreleasemanager/setup/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitreleasemanager/setup/task.json

@@ -1,6 +1,6 @@
 {
     "id": "e3022448-b00d-4b57-b504-606a0bcf8279",
-    "name": "gitreleasemanager-setup",
+    "name": "gitreleasemanager/setup",
     "friendlyName": "Setup GitReleaseManager Task",
     "description": "Tool for creating and exporting releases for software applications hosted on GitHub",
     "author": "GitTools Contributors",
@@ -20,7 +20,7 @@
             "workingDirectory": "."
         }
     },
-    "instanceNameFormat": "gitreleasemanager-setup",
+    "instanceNameFormat": "gitreleasemanager/setup",
     "inputs": [{
             "name": "versionSpec",
             "type": "string",

dist/azure/gitversion/execute/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitversion/execute/task.json

@@ -1,6 +1,6 @@
 {
     "id": "9013cf7f-ee8d-49f4-a39b-db244928d391",
-    "name": "gitversion-execute",
+    "name": "gitversion/execute",
     "friendlyName": "Execute GitVersion Task",
     "description": "Easy Semantic Versioning (http://semver.org) for projects using Git",
     "author": "GitTools Contributors",
@@ -20,7 +20,7 @@
             "workingDirectory": "."
         }
     },
-    "instanceNameFormat": "gitversion-execute",
+    "instanceNameFormat": "gitversion/execute",
     "groups": [{
             "name": "gitversionDetails",
             "displayName": "GitVersion details",

dist/azure/gitversion/setup/lib.json

@@ -0,0 +1,46 @@
+{
+    "messages": {
+        "LIB_UnhandledEx": "Unhandled: %s",
+        "LIB_FailOnCode": "Failure return code: %d",
+        "LIB_MkdirFailed": "Unable to create directory '%s'. %s",
+        "LIB_MkdirFailedFileExists": "Unable to create directory '%s'. Conflicting file exists: '%s'",
+        "LIB_MkdirFailedInvalidDriveRoot": "Unable to create directory '%s'. Root directory does not exist: '%s'",
+        "LIB_MkdirFailedInvalidShare": "Unable to create directory '%s'. Unable to verify the directory exists: '%s'. If directory is a file share, please verify the share name is correct, the share is online, and the current process has permission to access the share.",
+        "LIB_MultilineSecret": "Secrets cannot contain multiple lines",
+        "LIB_ProcessError": "There was an error when attempting to execute the process '%s'. This may indicate the process failed to start. Error: %s",
+        "LIB_ProcessExitCode": "The process '%s' failed with exit code %s",
+        "LIB_ProcessStderr": "The process '%s' failed because one or more lines were written to the STDERR stream",
+        "LIB_ReturnCode": "Return code: %d",
+        "LIB_ResourceFileNotExist": "Resource file doesn\\'t exist: %s",
+        "LIB_ResourceFileAlreadySet": "Resource file has already set to: %s",
+        "LIB_ResourceFileNotSet": "Resource file haven\\'t set, can\\'t find loc string for key: %s",
+        "LIB_StdioNotClosed": "The STDIO streams did not close within %s seconds of the exit event from process '%s'. This may indicate a child process inherited the STDIO streams and has not yet exited.",
+        "LIB_WhichNotFound_Linux": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.",
+        "LIB_WhichNotFound_Win": "Unable to locate executable file: '%s'. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.",
+        "LIB_LocStringNotFound": "Can\\'t find loc string for key: %s",
+        "LIB_ParameterIsRequired": "%s not supplied",
+        "LIB_InputRequired": "Input required: %s",
+        "LIB_InvalidPattern": "Invalid pattern: '%s'",
+        "LIB_EndpointNotExist": "Endpoint not present: %s",
+        "LIB_EndpointDataNotExist": "Endpoint data parameter %s not present: %s",
+        "LIB_EndpointAuthNotExist": "Endpoint auth data not present: %s",
+        "LIB_InvalidEndpointAuth": "Invalid endpoint auth: %s",
+        "LIB_InvalidSecureFilesInput": "Invalid secure file input: %s",
+        "LIB_PathNotFound": "Not found %s: %s",
+        "LIB_PathHasNullByte": "Path cannot contain null bytes",
+        "LIB_OperationFailed": "Failed %s: %s",
+        "LIB_UseFirstGlobMatch": "Multiple workspace matches. using first.",
+        "LIB_MergeTestResultNotSupported": "Merging test results from multiple files to one test run is not supported on this version of build agent for OSX/Linux, each test result file will be published as a separate test run in VSO/TFS.",
+        "LIB_PlatformNotSupported": "Platform not supported: %s",
+        "TOOL_LIB_CachingTool": "Caching tool: %s %s %s",
+        "_TOOL_LIB_CachingTool.comment": "This informational log message indicates that a tool, that was just downloaded, is being copied into the cache directory. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_Downloading": "Downloading: %s",
+        "_TOOL_LIB_Downloading.comment": "This information log message indicates that a file is being downloaded. %s represents the URL being downloaded.",
+        "TOOL_LIB_ExtractingArchive": "Extracting archive",
+        "_TOOL_LIB_ExtractingArchive.comment": "This informational log message indicates that an archive file is being extracted. For example, a .zip file, .7z file, or .tar.gz file.",
+        "TOOL_LIB_FoundInCache": "Found tool in cache: %s %s %s",
+        "_TOOL_LIB_FoundInCache.comment": "This informational log message indicates that the request tool is already cached, and does not need to be downloaded again. %s %s %s represent the tool name, version information, and processor architecture.",
+        "TOOL_LIB_PrependPath": "Prepending PATH environment variable with directory: %s",
+        "_TOOL_LIB_PrependPath.comment": "This informational log message indicates that a directory is being prepended to the front of the PATH environment variable. The directories specified by the PATH environment variable are used to resolve the location of command line tools."
+    }
+}

dist/azure/gitversion/setup/task.json

@@ -1,6 +1,6 @@
 {
     "id": "a06c02ae-7b9a-4082-90dc-fe27b500e54f",
-    "name": "gitversion-setup",
+    "name": "gitversion/setup",
     "friendlyName": "Setup GitVersion Task",
     "description": "Easy Semantic Versioning (http://semver.org) for projects using Git",
     "author": "GitTools Contributors",
@@ -20,7 +20,7 @@
             "workingDirectory": "."
         }
     },
-    "instanceNameFormat": "gitversion-setup",
+    "instanceNameFormat": "gitversion/setup",
     "inputs": [{
             "name": "versionSpec",
             "type": "string",

dist/azure/overview.md

@@ -2,5 +2,10 @@ Versioning when using Git, solved. GitVersion looks at your Git history and work
 
 It works with most branching strategies but has been designed mainly around GitFlow and GitHubFlow (pull request workflow). The calculated version numbers can then be accessed through variables such as `$(GitVersion.NuGetVersion)` and `$(GitVersion.SemVer)`. It is also very configurable to allow it to work with most release workflows!
 
-![Build Task](https://raw.githubusercontent.com/GitTools/actions/master/dist/azure/images/build-task.png)
-![Builds](https://raw.githubusercontent.com/GitTools/actions/master/dist/azure/images/builds.png)
+## Azure Pipelines tasks
+
+![Azure Pipelines Tasks](images/pipeline-editor-tasks.png)
+
+## Azure Pipelines run examples
+
+![Azure Pipelines Runs](images/builds.png)

dist/azure/update-version.ps1

@@ -10,14 +10,19 @@ function update-task() {
 
     [Parameter(Mandatory=$True, Position=2, ValueFromPipeline=$false)]
     [System.String]
-    $minor
+    $minor,
+
+    [Parameter(Mandatory=$True, Position=3, ValueFromPipeline=$false)]
+    [System.String]
+    $patch
 )
     $file = Resolve-Path $file
     $jqMajor = '.version.Major=\"' + $major +'\"';
     $jqMinor = '.version.Minor=\"' + $minor +'\"';
-    Write-Host "Update task from $file to version $major.$minor"
+    $jqPatch = '.version.Patch=\"' + $patch +'\"';
+    Write-Host "Update task from $file to version $major.$minor.$patch"
 
-    Get-Content $file | jq $jqMajor | jq $jqMinor | Set-Content $file
+    Get-Content $file | jq $jqMajor | jq $jqMinor| jq $jqPatch | Set-Content $file
 }
 
 function update-manifest() {

dist/azure/vss-extension.json

@@ -11,9 +11,16 @@
         "id": "Microsoft.VisualStudio.Services"
     }],
     "files": [
-        { "path": "setup-gitversion" },
-        { "path": "execute-gitversion" },
-        { "path": "setup-gitreleasemanager" }
+        { "path": "gitversion/setup" },
+        { "path": "gitversion/execute" },
+        { "path": "gitreleasemanager/setup" },
+        { "path": "gitreleasemanager/create" },
+        { "path": "gitreleasemanager/discard" },
+        { "path": "gitreleasemanager/close" },
+        { "path": "gitreleasemanager/open" },
+        { "path": "gitreleasemanager/publish" },
+        { "path": "gitreleasemanager/addasset" },
+        { "path": "images", "addressable": true }
     ],
     "categories": [
         "Azure Pipelines"
@@ -29,7 +36,8 @@
         "git",
         "versioning",
         "gitflow",
-        "githubflow"
+        "githubflow",
+        "release"
     ],
     "links": {
         "learn": {
@@ -48,11 +56,18 @@
             "uri": "https://github.com/GitTools/actions/issues"
         }
     },
-    "screenshots": [{
-            "path": "images/builds.png"
+    "screenshots": [
+        {
+            "path": "screenshots/pipeline-editor-setup-gitversion-task.png"
         },
         {
-            "path": "images/build-task.png"
+            "path": "screenshots/pipeline-run-setup-gitversion-task.png"
+        },
+        {
+            "path": "screenshots/pipeline-editor-execute-gitversion-task.png"
+        },
+        {
+            "path": "screenshots/pipeline-run-execute-gitversion-task.png"
         }
     ],
     "content": {
@@ -67,7 +82,7 @@
             "ms.vss-distributed-task.tasks"
         ],
         "properties": {
-            "name": "setup-gitversion"
+            "name": "gitversion/setup"
         }
     }, {
         "id": "execute-gitversion-task",
@@ -76,7 +91,7 @@
             "ms.vss-distributed-task.tasks"
         ],
         "properties": {
-            "name": "execute-gitversion"
+            "name": "gitversion/execute"
         }
     }, {
         "id": "setup-gitreleasemanager-task",
@@ -85,7 +100,61 @@
             "ms.vss-distributed-task.tasks"
         ],
         "properties": {
-            "name": "setup-gitreleasemanager"
+            "name": "gitreleasemanager/setup"
+        }
+    }, {
+        "id": "create-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/create"
+        }
+    }, {
+        "id": "discard-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/discard"
+        }
+    }, {
+        "id": "close-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/close"
+        }
+    }, {
+        "id": "open-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/open"
+        }
+    }, {
+        "id": "publish-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/publish"
+        }
+    }, {
+        "id": "addasset-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitreleasemanager/addasset"
         }
     }]
-}
+}

docs/examples/azure/gitreleasemanager/addasset.md

@@ -0,0 +1,14 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/addasset@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      tagName: '0.1.0'
+      assets: |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/azure/gitreleasemanager/close.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+    - task: gitreleasemanager/close@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/create.md

@@ -0,0 +1,16 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/create@0
+    displayName: Create release with GitReleaseManager
+    inputs:
+      token: $(GITHUB_TOKEN)
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+      name: 'v0.1.0'
+      assets: |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/azure/gitreleasemanager/discard.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/discard@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/index.md

@@ -0,0 +1,11 @@
+# GitReleaseManager Azure DevOps Action
+
+Below you'll find examples of how to do particular actions with GitReleaseManager:
+
+* [Add asset](addasset.md)
+* [Close](close.md)
+* [Create](create.md)
+* [Discard](discard.md)
+* [Open](open.md)
+* [Publish](publish.md)
+* [Setup](setup.md)

docs/examples/azure/gitreleasemanager/open.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+    - task: gitreleasemanager/open@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      milestone: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/publish.md

@@ -0,0 +1,11 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/publish@0
+    inputs:
+      token: '$(GITHUB_TOKEN)'
+      owner: 'someOwner'
+      repository: 'someRepo'
+      tagName: '0.1.0'
+```

docs/examples/azure/gitreleasemanager/setup.md

@@ -0,0 +1,9 @@
+# Example
+
+```yaml
+  steps:
+  - task: gitreleasemanager/setup@0
+    displayName: Install GitReleaseManager
+    inputs:
+      versionSpec: '0.10.x'
+```

docs/examples/azure/gitversion/execute/usage-examples.md

@@ -0,0 +1,299 @@
+# Execute GitVersion Task (gitversion/execute) Usage Examples
+
+Find out how to use the **gitversion/execute** task using the examples below.
+
+> The examples use the latest _0.x_ version of the GitVersion Execute task.  It is recommended to use the latest released version in your own pipelines.
+
+## Inputs
+
+The Execute GitVersion task accepts the following inputs:
+
+```yaml
+targetPath:
+  description: Optionally supply the path to the working directory.
+  required: false
+  default: ''
+useConfigFile:
+  description: Whether to use a custom configuration file.
+  required: false
+  default: false
+configFilePath:
+  description: Optional path to config file (defaults to GitVersion.yml).
+  required: false
+  default: ''
+updateAssemblyInfo:
+  description: Whether to update versions in the AssemblyInfo files.
+  required: false
+  default: false
+updateAssemblyInfoFilename:
+  description: Update versions in specified file.
+  required: false
+  default: ''
+additionalArguments:
+  description: Additional arguments to send to GitVersion.
+  required: false
+  default: ''
+```
+
+## Outputs
+
+The Execute GitVersion task creates the following job-scoped variables and multi-job output variables:
+
+- GitVersion.Major
+- GitVersion.Minor
+- GitVersion.Patch
+- GitVersion.PreReleaseTag
+- GitVersion.PreReleaseTagWithDash
+- GitVersion.PreReleaseLabel
+- GitVersion.PreReleaseNumber
+- GitVersion.WeightedPreReleaseNumber
+- GitVersion.BuildMetaData
+- GitVersion.BuildMetaDataPadded
+- GitVersion.FullBuildMetaData
+- GitVersion.MajorMinorPatch
+- GitVersion.SemVer
+- GitVersion.LegacySemVer
+- GitVersion.LegacySemVerPadded
+- GitVersion.AssemblySemVer
+- GitVersion.AssemblySemFileVer
+- GitVersion.FullSemVer
+- GitVersion.InformationalVersion
+- GitVersion.BranchName
+- GitVersion.EscapedBranchName (since 5.2.0)
+- GitVersion.Sha
+- GitVersion.ShortSha
+- GitVersion.NuGetVersionV2
+- GitVersion.NuGetVersion
+- GitVersion.NuGetPreReleaseTagV2
+- GitVersion.NuGetPreReleaseTag
+- GitVersion.VersionSourceSha
+- GitVersion.CommitsSinceVersionSource
+- GitVersion.CommitsSinceVersionSourcePadded (since 5.2.0)
+- GitVersion.UncommittedChanges (since 5.5.0)
+- GitVersion.CommitDate
+
+The job-scoped variables can be accessed using the macro syntax `$(GitVersion.<variableName>)` in subsequent steps in the same job.  Azure Pipelines also creates environment variables of the form `GITVERSION_<VARIABLENAME>`.  See examples [5](#example-5) and [6](#example-6).
+
+The multi-job output variables can be accessed across jobs and stages, in both conditions and variables.  See examples [7](#example-7) to [10](#example-10).
+
+**GitVersion also automatically updates the pre-defined Build variable `Build.BuildNumber`.**
+
+---
+
+## Examples
+
+### Example 1
+
+Calculate the version for the build.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+```
+
+### Example 2
+
+Calculate the version for the build using a config file with the default name **GitVersion.yml**.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+    inputs:
+      useConfigFile: true
+```
+
+Example contents of **GitVersion.yml**:
+
+```yaml
+mode: Mainline
+branches:
+  master:
+    regex: ^latest$
+  pull-request:
+    tag: pr
+```
+
+### Example 3
+
+Calculate the version for the build using a config file named **VersionConfig.yml** in the root of the working folder.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+    inputs:
+      useConfigFile: true
+      configFilePath: 'VersionConfig.yml'
+```
+
+### Example 4
+
+Show the effective configuration for GitVersion by running the **/showConfig** command (passed as an additional argument).
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Display GitVersion config
+    inputs:
+      additionalArguments: '/showConfig'
+```
+
+### Example 5
+
+Calculate the version for the build and display all the calculated variables in the next step.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+
+  - script: |
+      echo Major: $(GitVersion.Major)
+      echo Minor: $(GitVersion.Minor)
+      echo Patch: $(GitVersion.Patch)
+      echo PreReleaseTag: $(GitVersion.PreReleaseTag)
+      echo PreReleaseTagWithDash: $(GitVersion.PreReleaseTagWithDash)
+      echo PreReleaseLabel: $(GitVersion.PreReleaseLabel)
+      echo PreReleaseNumber: $(GitVersion.PreReleaseNumber)
+      echo WeightedPreReleaseNumber: $(GitVersion.WeightedPreReleaseNumber)
+      echo BuildMetaData: $(GitVersion.BuildMetaData)
+      echo BuildMetaDataPadded: $(GitVersion.BuildMetaDataPadded)
+      echo FullBuildMetaData: $(GitVersion.FullBuildMetaData)
+      echo MajorMinorPatch: $(GitVersion.MajorMinorPatch)
+      echo SemVer: $(GitVersion.SemVer)
+      echo LegacySemVer: $(GitVersion.LegacySemVer)
+      echo LegacySemVerPadded: $(GitVersion.LegacySemVerPadded)
+      echo AssemblySemVer: $(GitVersion.AssemblySemVer)
+      echo AssemblySemFileVer: $(GitVersion.AssemblySemFileVer)
+      echo FullSemVer: $(GitVersion.FullSemVer)
+      echo InformationalVersion: $(GitVersion.InformationalVersion)
+      echo BranchName: $(GitVersion.BranchName)
+      echo EscapedBranchName: $(GitVersion.EscapedBranchName)
+      echo Sha: $(GitVersion.Sha)
+      echo ShortSha: $(GitVersion.ShortSha)
+      echo NuGetVersionV2: $(GitVersion.NuGetVersionV2)
+      echo NuGetVersion: $(GitVersion.NuGetVersion)
+      echo NuGetPreReleaseTagV2: $(GitVersion.NuGetPreReleaseTagV2)
+      echo NuGetPreReleaseTag: $(GitVersion.NuGetPreReleaseTag)
+      echo VersionSourceSha: $(GitVersion.VersionSourceSha)
+      echo CommitsSinceVersionSource: $(GitVersion.CommitsSinceVersionSource)
+      echo CommitsSinceVersionSourcePadded: $(GitVersion.CommitsSinceVersionSourcePadded)
+      echo UncommittedChanges: $(GitVersion.UncommittedChanges)
+      echo CommitDate: $(GitVersion.CommitDate)
+```
+
+### Example 6
+
+Calculate the version for the build and use the `GitVersion.NuGetVersion` variable to set the NuGet package version.
+
+```yaml
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Determine Version
+
+  - task: DotNetCoreCLI@2
+    displayName: Pack Example
+    inputs:
+      command: pack
+      packagesToPack: src/Example/LibExample.csproj
+      versioningScheme: byEnvVar
+      versionEnvVar: GitVersion.NuGetVersion # alternative syntax GITVERSION_NUGETVERSION (the former gets converted into the latter internally)
+```
+
+### Example 7
+
+Calculate the version for the build and use the `GitVersion.BranchName` variable in a condition for starting another job.
+
+```yaml
+job: CalculateVersion
+displayName: Calculate version using GitVersion
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Use GitVersion
+    name: Version # the step MUST be named to access its output variables in another job.
+
+job: CreateReleaseNotes
+condition: and(succeeded(), eq(dependencies.CalculateVersion.outputs['Version.GitVersion.BranchName'], 'main')
+dependsOn: CalculateVersion
+```
+
+### Example 8
+
+Calculate the version for the build and map the `GitVersion.SemVer` variable into a variable in another job.
+
+```yaml
+job: CalculateVersion
+displayName: Calculate version using GitVersion
+steps:
+  # gitversion/setup@0 task omitted for brevity.
+
+  - task: gitversion/execute@0
+    displayName: Use GitVersion
+    name: Version # the step MUST be named to access its output variables in another job.
+
+job: BuildAndPack
+variables:
+  Ver.MajorMinorPatch: $[ dependencies.CalculateVersion.outputs['Version.GitVersion.MajorMinorPatch'] ]
+```
+
+### Example 9
+
+Calculate the version for the build and use the `GitVersion.Major` output variable in a condition for starting another stage.
+
+```yaml
+stages:
+  - stage: S1
+    jobs:
+      - job: CalculateVersion
+        displayName: Calculate version number using GitVersion
+        steps:
+          # gitversion/setup@0 task omitted for brevity.
+
+          - task: gitversion/execute@0
+            displayName: Use GitVersion
+            name: Version # the step MUST be named to access its output variables in another stage.
+
+  - stage: S2
+    condition: and(succeeded(), gt(dependencies.S1.outputs['CalculateVersion.Version.GitVersion.Major'], 0))
+    dependsOn: S1
+```
+
+### Example 10
+
+Calculate the version for the build and map the `GitVersion.AssemblySemVer` variable into a variable in another job for a different stage.
+
+```yaml
+stages:
+  - stage: S1
+    jobs:
+      - job: CalculateVersion
+        displayName: Calculate version number using GitVersion
+        steps:
+          # gitversion/setup@0 task omitted for brevity.
+
+          - task: gitversion/execute@0
+            displayName: Use GitVersion
+            name: Version # the step MUST be named to access its output variables in another stage.
+  - stage: S2
+    dependsOn: S1
+    jobs:
+      - job: UpdateAssemblyVersions
+        variables:
+          Ver.AssemblyVer: $[ stageDependencies.S1.CalculateVersion.outputs['Version.GitVersion.AssemblySemVer'] ] # Note the 'stageDependencies.<jobName>' syntax.
+```

docs/examples/azure/gitversion/index.md

@@ -0,0 +1,11 @@
+# GitVersion Tasks Usage Examples
+
+Use the following links to see usage examples of the Setup GitVersion (**gitversion/setup**) and Execute GitVersion (**gitversion/execute**) tasks.
+
+## Setup GitVersion (gitversion/setup)
+
+- [Usage examples](setup/usage-examples.md)
+
+## Execute GitVersion (gitversion/execute)
+
+- [Usage examples](execute/usage-examples.md)

docs/examples/azure/gitversion/setup/usage-examples.md

@@ -0,0 +1,61 @@
+# Setup GitVersion Task (gitversion/setup) Usage Examples
+
+Find out how to use the **gitversion/setup** task using the examples below.
+
+> The examples use the latest _0.x_ version of the GitVersion Setup task.  It is recommended to use the latest released version in your own pipelines.
+
+## Inputs
+
+The Setup GitVersion task accepts the following inputs:
+
+```yaml
+versionSpec:
+  description: Required version in the form of 5.x or exact version like 5.0.0.
+  required: true
+  default: ''
+includePrerelease:
+  description: Include pre-release versions when matching a version.
+  required: false
+  default: false
+```
+
+---
+
+## Usage examples
+
+### Example 1
+
+Install the latest GitVersion 5 version.
+
+```yaml
+steps:
+  - task: gitversion/setup@0
+    displayName: Install GitVersion
+    inputs:
+      versionSpec: '5.x'
+```
+
+### Example 2
+
+Install GitVersion 5.5.0.
+
+```yaml
+steps:
+  - task: gitversion/setup@0
+    displayName: Install GitVersion
+    inputs:
+      versionSpec: '5.5.0'
+```
+
+### Example 3
+
+Install the latest GitVersion 6 pre-release version.  For example **6.0.0-beta1.1**.
+
+```yaml
+steps:
+  - task: gitversion/setup@0
+    displayName: Install GitVersion
+    inputs:
+      versionSpec: '6.x'
+      includePrerelease: true
+```

docs/examples/github/gitreleasemanager/addasset.md

@@ -0,0 +1,15 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/addasset@v0.9.2
+    name: Add asset to a release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      tagName: '0.1.0'
+      assets: |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/github/gitreleasemanager/close.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/close@v0.9.2
+    name: Close release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+```

docs/examples/github/gitreleasemanager/create.md

@@ -0,0 +1,16 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/create@v0.9.2
+    name: Create release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+      name: 'v0.1.0'
+      assets:  |
+        src/test.txt
+        src/test1.txt
+```

docs/examples/github/gitreleasemanager/discard.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/discard@v0.9.2
+    name: Discard release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+```

docs/examples/github/gitreleasemanager/index.md

@@ -0,0 +1,11 @@
+# GitReleaseManager GitHub Action
+
+Below you'll find examples of how to do particular actions with GitReleaseManager:
+
+* [Add asset](addasset.md)
+* [Close](close.md)
+* [Create](create.md)
+* [Discard](discard.md)
+* [Open](open.md)
+* [Publish](publish.md)
+* [Setup](setup.md)

docs/examples/github/gitreleasemanager/open.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/open@v0.9.2
+    name: Open release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      milestone: '0.1.0'
+```

docs/examples/github/gitreleasemanager/publish.md

@@ -0,0 +1,12 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/publish@v0.9.2
+    name: Publish release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      tagName: '0.1.0'
+```