dist update

Bump semver from 7.5.4 to 7.6.0

.azure/ci.yml

@@ -0,0 +1,47 @@
+trigger:
+  - main
+pr:
+  - main
+
+variables:
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 'true'
+  DOTNET_CLI_TELEMETRY_OPTOUT: 'true'
+  INPUT_VERSIONSPEC: '5.x'
+
+jobs:
+- job: build
+  displayName: ''
+  strategy:
+    matrix:
+      'ubuntu-latest':
+        imageName: 'ubuntu-latest'
+      'macos-latest':
+        imageName: 'macos-latest'
+      'windows-latest':
+        imageName: 'windows-latest'
+
+  pool:
+    vmImage: $(imageName)
+
+  steps:
+    - checkout: self
+      fetchDepth: '0'
+    - pwsh: |
+        npm install
+        npm run format-check
+        npm run build:github
+        npm run build:azure
+      displayName: 'Build code'
+    - pwsh: $env:INPUT_VERSIONSPEC = "$(INPUT_VERSIONSPEC)"; node ./gitversion/setup/bundle.js
+      displayName: gitversion/setup
+      workingDirectory: dist/azure
+    - pwsh: node ./gitversion/execute/bundle.js
+      name: version
+      displayName: gitversion/execute
+      workingDirectory: dist/azure
+    - pwsh: |
+        echo "FullSemVer (fullSemVer)                    : $(fullSemVer)"
+        echo "FullSemVer (GitVersion_FullSemVer)         : $(GitVersion_FullSemVer)"
+        echo "FullSemVer (version.fullSemVer)            : $(version.fullSemVer)"
+        echo "FullSemVer (version.GitVersion_FullSemVer) : $(version.GitVersion_FullSemVer)"
+      displayName: Use variables and output

.editorconfig

@@ -0,0 +1,17 @@
+# 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
+max_line_length = off
+
+[*.yml]
+indent_size = 2
+
+[*.md]
+indent_size = 2

.github/dependabot.yml

@@ -0,0 +1,15 @@
+version: 2
+updates:
+- package-ecosystem: github-actions
+  labels:
+    - "dependencies"
+  commit-message:
+    prefix: "(build deps)"
+  directory: "/"
+  schedule:
+    interval: daily
+- package-ecosystem: npm
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10

.github/mergify.yml

@@ -0,0 +1,23 @@
+pull_request_rules:
+  - name: Automatic approve on dependabot PR
+    conditions:
+      - author~=^dependabot(|-preview)\[bot\]$
+    actions:
+      review:
+        type: APPROVE
+  - name: Automatic merge on dependabot PR after success CI
+    conditions:
+      - author~=^dependabot(|-preview)\[bot\]$
+      - '#commits-behind=0' # Only merge up to date pull requests
+      - check-success=build (windows-latest)
+      - check-success=build (ubuntu-latest)
+      - check-success=build (macos-latest)
+    actions:
+      merge:
+  - name: Thank contributor
+    conditions:
+      - merged
+      - -author~=^dependabot(|-preview)\[bot\]$
+    actions:
+      comment:
+        message: "Thank you @{{author}} for your contribution!"

.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,16 @@
 name: CI
-on: [push, pull_request]
+on:
+  push:
+    branches:
+    - main
+
+  pull_request:
+    branches:
+    - main
+
+defaults:
+  run:
+    shell: pwsh
 
 jobs:
   build:
@@ -8,18 +19,49 @@ jobs:
     strategy:
       matrix:
         os: [windows-latest, ubuntu-latest, macos-latest]
+      fail-fast: false
     steps:
-    - uses: actions/checkout@v1
-    - name: Fetch tags and master for GitVersion
-      run: |
-        git fetch --tags
-        git branch --create-reflog master origin/master
-    - name: Install GitVersion
-      uses: ./setup
+    - uses: actions/checkout@v4
+      if: github.event_name == 'push'
       with:
-        versionSpec: '5.1.x'
-    - name: Use GitVersion
-      id: gitversion # step id used as reference for output values
-      uses: ./execute
+        token: ${{ secrets.PUSH_GITHUB_TOKEN }}
+    - uses: actions/checkout@v4
+      if: github.event_name == 'pull_request'
+    - name: Fetch all history for all tags and branches
+      run: |
+        git fetch --prune --unshallow
+    - uses: actions/setup-node@v4
+      with:
+        node-version: '20'
     - run: |
-        echo "FullSemVer: ${{ steps.gitversion.outputs.FullSemVer }}"
+        npm install
+        npm run format-check
+        npm run build:github
+        npm run build:azure
+      name: Build code
+    - name: gitversion/setup
+      uses: ./gitversion/setup
+      with:
+        versionSpec: '5.x'
+    - name: gitversion/execute
+      id: gitversion # step id used as reference for output values
+      uses: ./gitversion/execute
+    - run: |
+        echo "FullSemVer (env.fullSemVer)                                 : ${{ env.fullSemVer }}"
+        echo "FullSemVer (env.GitVersion_FullSemVer)                      : ${{ env.GitVersion_FullSemVer }}"
+        echo "FullSemVer (steps.gitversion.outputs.fullSemVer)            : ${{ steps.gitversion.outputs.fullSemVer }}"
+        echo "FullSemVer (steps.gitversion.outputs.GitVersion_FullSemVer) : ${{ steps.gitversion.outputs.GitVersion_FullSemVer }}"
+      name: Use variables and output
+    - name: Check for changes
+      if: matrix.os == 'ubuntu-latest' && github.event_name == 'push'
+      id: status
+      run: |
+        if ($null -ne (git status --porcelain)) { echo "has_changes=1"; echo "has_changes=1" >> $env:GITHUB_OUTPUT }
+    - name: Rebuild dist and push
+      run: |
+        git add --verbose .
+        git config user.name 'Artur Stolear'
+        git config user.email 'artur.stolear@gmail.com'
+        git commit -m 'dist update' --allow-empty
+        git push --force
+      if: steps.status.outputs.has_changes == '1'

.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: release
+on:
+  release:
+    types: [published]
+
+defaults:
+  run:
+    shell: pwsh
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v4
+    - name: Fetch all history for all tags and branches
+      run: |
+        git fetch --prune --unshallow
+    - run: |
+        npm install
+        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.x'
+    - name: Use GitVersion
+      id: gitversion # step id used as reference for output values
+      uses: ./gitversion/execute
+    - run: |
+        $date = Get-Date -format "yyMMddHH"
+        $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 # Import the functions
+        update-manifest .\dist\azure\vss-extension.json -Version $version
+        dir -r .\dist\**\task.json | % { update-task $_ -Major $major -Minor $minor -Patch $patch }
+
+        npm run publish:azure -- --token ${{ secrets.TFX_TOKEN }}
+
+      name: Publish Azure extension

.gitignore

@@ -2,4 +2,8 @@ node_modules/
 
 .taskkey
 *.js
-!dist/**/*.js
+!dist/**/*.js
+*.vsix
+
+.idea/
+/dist/mock/

.prettierignore

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

.prettierrc.json

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

.vscode/launch.json

@@ -5,40 +5,52 @@
     "version": "0.2.0",
     "configurations": [
         {
-
             "type": "node",
             "request": "launch",
-            "preLaunchTask": "tsc: build - src/azure/tsconfig.json",
-            "name": "Run Azure Pipeline (setup) Task",
-            "program": "${workspaceFolder}/src/azure/setup.ts",
-            "outFiles": ["${workspaceFolder}/**/*.js"]
+            "preLaunchTask": "Build-Mock",
+            "name": "Debug Mock Setup GitVersion",
+            "program": "${workspaceFolder}/dist/mock/gitversion/setup/bundle.js",
+            "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
-
             "type": "node",
             "request": "launch",
-            "preLaunchTask": "tsc: build - src/github/tsconfig.json",
-            "name": "Run GitHub Actions (setup)",
-            "program": "${workspaceFolder}/src/github/setup.ts",
-            "outFiles": ["${workspaceFolder}/**/*.js"]
+            "preLaunchTask": "Build-Azure",
+            "name": "Debug Azure Setup GitVersion",
+            "program": "${workspaceFolder}/dist/azure/gitversion/setup/bundle.js",
+            "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
-
             "type": "node",
             "request": "launch",
-            "preLaunchTask": "tsc: build - src/azure/tsconfig.json",
-            "name": "Run Azure Pipeline (execute) Task",
-            "program": "${workspaceFolder}/src/azure/execute.ts",
-            "outFiles": ["${workspaceFolder}/**/*.js"]
+            "preLaunchTask": "Build-GitHub",
+            "name": "Debug GitHub Setup GitVersion",
+            "program": "${workspaceFolder}/dist/github/gitversion/setup/bundle.js",
+            "outFiles": [ "${workspaceFolder}/**/*.js" ]
         },
         {
-
             "type": "node",
             "request": "launch",
-            "preLaunchTask": "tsc: build - src/github/tsconfig.json",
-            "name": "Run GitHub Actions (execute)",
-            "program": "${workspaceFolder}/src/github/execute.ts",
-            "outFiles": ["${workspaceFolder}/**/*.js"]
-        }
+            "preLaunchTask": "Build-Mock",
+            "name": "Debug Mock Execute GitVersion",
+            "program": "${workspaceFolder}/dist/mock/gitversion/execute/bundle.js",
+            "outFiles": [ "${workspaceFolder}/**/*.js" ]
+        },
+        {
+            "type": "node",
+            "request": "launch",
+            "preLaunchTask": "Build-Azure",
+            "name": "Debug Azure Execute GitVersion",
+            "program": "${workspaceFolder}/dist/azure/gitversion/execute/bundle.js",
+            "outFiles": [ "${workspaceFolder}/**/*.js" ]
+        },
+        {
+            "type": "node",
+            "request": "launch",
+            "preLaunchTask": "Build-GitHub",
+            "name": "Debug GitHub Execute GitVersion",
+            "program": "${workspaceFolder}/dist/github/gitversion/execute/bundle.js",
+            "outFiles": [ "${workspaceFolder}/**/*.js" ]
+        },
     ]
 }

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "yaml.schemas": {
+        "file:///c%3A/Users/Artur.Stolear/.vscode/extensions/docsmsft.docs-yaml-0.2.9/out/yaml-support/toc.schema.json": "/toc\\.yml/i",
+        "https://raw.githubusercontent.com/microsoft/azure-pipelines-vscode/master/service-schema.json": "file:///d%3A/Projects/OSS/GitTools/actions/.azure/ci.yml"
+    }
+}

.vscode/tasks.json

@@ -0,0 +1,22 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Build-Mock",
+            "type": "npm",
+            "script": "build:mock"
+        },
+        {
+            "label": "Build-Azure",
+            "type": "npm",
+            "script": "build:azure"
+        },
+        {
+            "label": "Build-GitHub",
+            "type": "npm",
+            "script": "build:github"
+        },
+    ]
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Git Tools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,43 +1,29 @@
-# use-gitversion
+# GitTools actions
 
-![GitVersion](https://raw.githubusercontent.com/GitTools/GitVersion/master/docs/img/package_icon.png "GitVersion")
+![GitTools](docs/icon.png "GitTools")
 
-Github Action that installs and uses the GitVersion tool
+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-gittools-blue?logo=github)](https://github.com/marketplace/actions/gittools)
 
 ## Usage
 
-See [setup](setup/action.yml) and [usage](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@v1
-    - name: Fetch tags and master for GitVersion
-    run: |
-        git fetch --tags
-        git branch --create-reflog master origin/master
-```
+### GitReleaseManager
 
-Basic:
+Examples for usage of **GitReleaseManager**:
 
-```yaml
-    steps:
-    - uses: actions/checkout@v1
-    - name: Fetch tags and master for GitVersion
-      run: |
-          git fetch --tags
-          git branch --create-reflog master origin/master
-    - name: Install GitVersion
-      uses: gittools/use-gitversion/setup@v0.2
-      with:
-          versionSpec: '5.1.x'
-    - name: Use GitVersion
-      id: gitversion # step id used as reference for output values
-      uses: gittools/use-gitversion/execute@v0.2
-    - run: |
-        echo "FullSemVer: ${{ steps.gitversion.outputs.FullSemVer }}"
-```
+- [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-gitversion
-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
+  using: node20
+  main: dist/github/setup/index.js

dist/azure/execute/lib.json

@@ -1,14 +0,0 @@
-{
-    "messages": {
-        "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/execute/lib1.json

@@ -1,36 +0,0 @@
-{
-  "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"
-  } 
-}

dist/azure/gitreleasemanager/addasset/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/addasset/task.json

@@ -0,0 +1,79 @@
+{
+    "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.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "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/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/close/task.json

@@ -0,0 +1,71 @@
+{
+    "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.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "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/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/create/task.json

@@ -0,0 +1,111 @@
+{
+    "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.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "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,71 @@
+{
+    "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.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "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,71 @@
+{
+    "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.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "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,71 @@
+{
+    "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.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "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

@@ -0,0 +1,63 @@
+{
+    "id": "e3022448-b00d-4b57-b504-606a0bcf8279",
+    "name": "gitreleasemanager/setup",
+    "friendlyName": "Setup 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.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitreleasemanager/setup",
+    "inputs": [
+        {
+            "name": "versionSpec",
+            "type": "string",
+            "label": "The version spec",
+            "defaultValue": "",
+            "required": true,
+            "helpMarkDown": "Required version in the form of 0.10.x or exact version like 0.10.2"
+        },
+        {
+            "name": "includePrerelease",
+            "type": "boolean",
+            "label": "Include pre-release versions",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Include pre-release versions when matching a version"
+        },
+        {
+            "name": "ignoreFailedSources",
+            "type": "boolean",
+            "label": "Treat package source failures as warnings",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Treat package source failures as warnings"
+        },
+        {
+            "name": "preferLatestVersion",
+            "type": "boolean",
+            "label": "Prefer latest version",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Prefer to download the latest version matching the versionSpec, even if there is a local cached version."
+        }
+    ]
+}

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

@@ -0,0 +1,95 @@
+{
+    "id": "9013cf7f-ee8d-49f4-a39b-db244928d391",
+    "name": "gitversion/execute",
+    "friendlyName": "Execute GitVersion Task",
+    "description": "Easy Semantic Versioning (https://semver.org) for projects using Git",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gitversion.net/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitversion/execute",
+    "groups": [
+        {
+            "name": "gitversionDetails",
+            "displayName": "GitVersion details",
+            "isExpanded": true
+        },
+        {
+            "name": "additional",
+            "displayName": "Additional Options",
+            "isExpanded": false
+        }
+    ],
+    "inputs": [
+        {
+            "name": "targetPath",
+            "type": "string",
+            "label": "Working directory path",
+            "defaultValue": "",
+            "required": false,
+            "helpMarkDown": "Optionally supply the path to the working directory",
+            "groupName": "gitversionDetails"
+        },
+        {
+            "name": "useConfigFile",
+            "type": "boolean",
+            "label": "Specify Configuration file",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Whether to use a custom configuration file"
+        },
+        {
+            "name": "configFilePath",
+            "type": "filePath",
+            "label": "Configuration file",
+            "defaultValue": "",
+            "required": false,
+            "helpMarkDown": "Optional path to config file (defaults to GitVersion.yml)",
+            "visibleRule": "useConfigFile = true"
+        },
+        {
+            "name": "updateAssemblyInfo",
+            "type": "boolean",
+            "label": "Update AssemblyInfo files",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Whether to update versions in the AssemblyInfo files"
+        },
+        {
+            "name": "updateAssemblyInfoFilename",
+            "type": "string",
+            "label": "Update Assembly File",
+            "defaultValue": "",
+            "required": false,
+            "helpMarkDown": "Update versions in specified file",
+            "visibleRule": "updateAssemblyInfo = true"
+        },
+        {
+            "name": "additionalArguments",
+            "type": "string",
+            "label": "Additional GitVersion arguments",
+            "defaultValue": "",
+            "required": false,
+            "helpMarkDown": "Additional arguments to send to GitVersion",
+            "groupName": "additional"
+        }
+    ]
+}

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

@@ -0,0 +1,63 @@
+{
+    "id": "a06c02ae-7b9a-4082-90dc-fe27b500e54f",
+    "name": "gitversion/setup",
+    "friendlyName": "Setup GitVersion Task",
+    "description": "Easy Semantic Versioning (https://semver.org) for projects using Git",
+    "author": "GitTools Contributors",
+    "helpMarkDown": "See the [documentation](https://gitversion.net/docs/) for help",
+    "category": "Build",
+    "demands": [],
+    "version": {
+        "Major": "1",
+        "Minor": "0",
+        "Patch": "0"
+    },
+    "minimumAgentVersion": "2.220.0",
+    "execution": {
+        "Node10": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        },
+        "Node20": {
+            "target": "bundle.js",
+            "argumentFormat": "",
+            "workingDirectory": "."
+        }
+    },
+    "instanceNameFormat": "gitversion/setup",
+    "inputs": [
+        {
+            "name": "versionSpec",
+            "type": "string",
+            "label": "The version spec",
+            "defaultValue": "",
+            "required": true,
+            "helpMarkDown": "Required version in the form of 5.x or exact version like 5.0.0"
+        },
+        {
+            "name": "includePrerelease",
+            "type": "boolean",
+            "label": "Include pre-release versions",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Include pre-release versions when matching a version"
+        },
+        {
+            "name": "ignoreFailedSources",
+            "type": "boolean",
+            "label": "Treat package source failures as warnings",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Treat package source failures as warnings"
+        },
+        {
+            "name": "preferLatestVersion",
+            "type": "boolean",
+            "label": "Prefer latest version",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "Prefer to download the latest version matching the versionSpec, even if there is a local cached version."
+        }
+    ]
+}

dist/azure/lib.json

@@ -1,14 +0,0 @@
-{
-    "messages": {
-        "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/lib1.json

@@ -1,36 +0,0 @@
-{
-  "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"
-  } 
-}

dist/azure/overview.md

@@ -0,0 +1,11 @@
+Versioning when using Git, solved. GitVersion looks at your Git history and works out the [semantic version](http://semver.org) of the commit being built.
+
+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!
+
+## Azure Pipelines tasks
+
+![Azure Pipelines Tasks](images/pipeline-editor-tasks.png)
+
+## Azure Pipelines run examples
+
+![Azure Pipelines Runs](images/builds.png)

dist/azure/setup/lib.json

@@ -1,14 +0,0 @@
-{
-    "messages": {
-        "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/setup/lib1.json

@@ -1,36 +0,0 @@
-{
-  "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"
-  } 
-}

dist/azure/update-version.ps1

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

dist/azure/vss-extension.json

@@ -0,0 +1,160 @@
+{
+    "manifestVersion": 1,
+    "id": "gittools",
+    "name": "GitTools",
+    "version": "0.0.1",
+    "publisher": "gittools",
+    "public": true,
+    "author": "GitTools Contributors",
+    "description": "Build tasks for easy semantic versioning for projects using Git and release management.",
+    "targets": [{
+        "id": "Microsoft.VisualStudio.Services"
+    }],
+    "files": [
+        { "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"
+    ],
+    "galleryFlags": [
+        "Public"
+    ],
+    "icons": {
+        "default": "images/icon.png"
+    },
+    "tags": [
+        "semver",
+        "git",
+        "versioning",
+        "gitflow",
+        "githubflow",
+        "release"
+    ],
+    "links": {
+        "learn": {
+            "uri": "https://github.com/GitTools/actions"
+        },
+        "getstarted": {
+            "uri": "https://github.com/GitTools/actions"
+        },
+        "license": {
+            "uri": "https://github.com/GitTools/actions/blob/master/LICENSE"
+        },
+        "repository": {
+            "uri": "https://github.com/GitTools/actions.git"
+        },
+        "support": {
+            "uri": "https://github.com/GitTools/actions/issues"
+        }
+    },
+    "screenshots": [
+        {
+            "path": "screenshots/pipeline-editor-setup-gitversion-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": {
+        "details": {
+            "path": "overview.md"
+        }
+    },
+    "contributions": [{
+        "id": "setup-gitversion-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitversion/setup"
+        }
+    }, {
+        "id": "execute-gitversion-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "name": "gitversion/execute"
+        }
+    }, {
+        "id": "setup-gitreleasemanager-task",
+        "type": "ms.vss-distributed-task.task",
+        "targets": [
+            "ms.vss-distributed-task.tasks"
+        ],
+        "properties": {
+            "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,417 @@
+# 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.
+
+Note that if the pipeline is setup to use a shallow git fetch mode the GitVersion Execute task will fail. It is required to use fetchDepth of 0 like so:
+
+```yaml
+- checkout: self
+  fetchDepth: 0
+```
+
+## 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:
+
+- major
+- minor
+- patch
+- preReleaseTag
+- preReleaseTagWithDash
+- preReleaseLabel
+- preReleaseNumber
+- weightedPreReleaseNumber
+- buildMetaData
+- buildMetaDataPadded (removed in 6.0.0)
+- fullBuildMetaData
+- majorMinorPatch
+- semVer
+- legacySemVer (removed in 6.0.0)
+- legacySemVerPadded (removed in 6.0.0)
+- assemblySemVer
+- assemblySemFileVer
+- fullSemVer
+- informationalVersion
+- branchName
+- escapedBranchName (since 5.2.0)
+- sha
+- shortSha
+- nuGetVersionV2 (removed in 6.0.0)
+- nuGetVersion (removed in 6.0.0)
+- nuGetPreReleaseTagV2 (removed in 6.0.0)
+- nuGetPreReleaseTag (removed in 6.0.0)
+- versionSourceSha
+- commitsSinceVersionSource
+- commitsSinceVersionSourcePadded (since 5.2.0, removed in 6.0.0)
+- uncommittedChanges (since 5.5.0)
+- commitDate
+
+The outputs can be accessed using the syntax `$(<id>.<outputName>)` or `$(<id>.GitVersion_<OutputName>)`, where `<id>` is the ID assigned to the step that calls the action, by subsequent steps later in the same job.  See example [5](#example-5).
+
+The action also creates environment variables of the form `$(<outputName>)` or `$(GitVersion_<OutputName>)` for use by other steps in the same job.  See example [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
+    name: version # id to later be referenced
+    displayName: Determine Version
+
+  - displayName: Display GitVersion outputs (step output)
+    script: |
+      echo "Major: $(version.major)"
+      echo "Minor: $(version.minor)"
+      echo "Patch: $(version.patch)"
+      echo "PreReleaseTag: $(version.preReleaseTag)"
+      echo "PreReleaseTagWithDash: $(version.preReleaseTagWithDash)"
+      echo "PreReleaseLabel: $(version.preReleaseLabel)"
+      echo "PreReleaseNumber: $(version.preReleaseNumber)"
+      echo "WeightedPreReleaseNumber: $(version.weightedPreReleaseNumber)"
+      echo "BuildMetaData: $(version.buildMetaData)"
+      echo "BuildMetaDataPadded: $(version.buildMetaDataPadded)"
+      echo "FullBuildMetaData: $(version.fullBuildMetaData)"
+      echo "MajorMinorPatch: $(version.majorMinorPatch)"
+      echo "SemVer: $(version.semVer)"
+      echo "LegacySemVer: $(version.legacySemVer)"
+      echo "LegacySemVerPadded: $(version.legacySemVerPadded)"
+      echo "AssemblySemVer: $(version.assemblySemVer)"
+      echo "AssemblySemFileVer: $(version.assemblySemFileVer)"
+      echo "FullSemVer: $(version.fullSemVer)"
+      echo "InformationalVersion: $(version.informationalVersion)"
+      echo "BranchName: $(version.branchName)"
+      echo "EscapedBranchName: $(version.escapedBranchName)"
+      echo "Sha: $(version.sha)"
+      echo "ShortSha: $(version.shortSha)"
+      echo "NuGetVersionV2: $(version.nuGetVersionV2)"
+      echo "NuGetVersion: $(version.nuGetVersion)"
+      echo "NuGetPreReleaseTagV2: $(version.nuGetPreReleaseTagV2)"
+      echo "NuGetPreReleaseTag: $(version.nuGetPreReleaseTag)"
+      echo "VersionSourceSha: $(version.versionSourceSha)"
+      echo "CommitsSinceVersionSource: $(version.commitsSinceVersionSource)"
+      echo "CommitsSinceVersionSourcePadded: $(version.commitsSinceVersionSourcePadded)"
+      echo "UncommittedChanges: $(version.uncommittedChanges)"
+      echo "CommitDate: $(version.commitDate)"
+
+  - displayName: Display GitVersion outputs (step output with prefix)
+    script: |
+      echo "Major: $(version.GitVersion_Major)"
+      echo "Minor: $(version.GitVersion_Minor)"
+      echo "Patch: $(version.GitVersion_Patch)"
+      echo "PreReleaseTag: $(version.GitVersion_PreReleaseTag)"
+      echo "PreReleaseTagWithDash: $(version.GitVersion_PreReleaseTagWithDash)"
+      echo "PreReleaseLabel: $(version.GitVersion_PreReleaseLabel)"
+      echo "PreReleaseNumber: $(version.GitVersion_PreReleaseNumber)"
+      echo "WeightedPreReleaseNumber: $(version.GitVersion_WeightedPreReleaseNumber)"
+      echo "BuildMetaData: $(version.GitVersion_BuildMetaData)"
+      echo "BuildMetaDataPadded: $(version.GitVersion_BuildMetaDataPadded)"
+      echo "FullBuildMetaData: $(version.GitVersion_FullBuildMetaData)"
+      echo "MajorMinorPatch: $(version.GitVersion_MajorMinorPatch)"
+      echo "SemVer: $(version.GitVersion_SemVer)"
+      echo "LegacySemVer: $(version.GitVersion_LegacySemVer)"
+      echo "LegacySemVerPadded: $(version.GitVersion_LegacySemVerPadded)"
+      echo "AssemblySemVer: $(version.GitVersion_AssemblySemVer)"
+      echo "AssemblySemFileVer: $(version.GitVersion_AssemblySemFileVer)"
+      echo "FullSemVer: $(version.GitVersion_FullSemVer)"
+      echo "InformationalVersion: $(version.GitVersion_InformationalVersion)"
+      echo "BranchName: $(version.GitVersion_BranchName)"
+      echo "EscapedBranchName: $(version.GitVersion_EscapedBranchName)"
+      echo "Sha: $(version.GitVersion_Sha)"
+      echo "ShortSha: $(version.GitVersion_ShortSha)"
+      echo "NuGetVersionV2: $(version.GitVersion_NuGetVersionV2)"
+      echo "NuGetVersion: $(version.GitVersion_NuGetVersion)"
+      echo "NuGetPreReleaseTagV2: $(version.GitVersion_NuGetPreReleaseTagV2)"
+      echo "NuGetPreReleaseTag: $(version.GitVersion_NuGetPreReleaseTag)"
+      echo "VersionSourceSha: $(version.GitVersion_VersionSourceSha)"
+      echo "CommitsSinceVersionSource: $(version.GitVersion_CommitsSinceVersionSource)"
+      echo "CommitsSinceVersionSourcePadded: $(version.GitVersion_CommitsSinceVersionSourcePadded)"
+      echo "UncommittedChanges: $(version.GitVersion_UncommittedChanges)"
+      echo "CommitDate: $(version.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
+
+  - displayName: Display GitVersion variables (without prefix)
+    script: |
+      echo "Major: $(major)"
+      echo "Minor: $(minor)"
+      echo "Patch: $(patch)"
+      echo "PreReleaseTag: $(preReleaseTag)"
+      echo "PreReleaseTagWithDash: $(preReleaseTagWithDash)"
+      echo "PreReleaseLabel: $(preReleaseLabel)"
+      echo "PreReleaseNumber: $(preReleaseNumber)"
+      echo "WeightedPreReleaseNumber: $(weightedPreReleaseNumber)"
+      echo "BuildMetaData: $(buildMetaData)"
+      echo "BuildMetaDataPadded: $(buildMetaDataPadded)"
+      echo "FullBuildMetaData: $(fullBuildMetaData)"
+      echo "MajorMinorPatch: $(majorMinorPatch)"
+      echo "SemVer: $(semVer)"
+      echo "LegacySemVer: $(legacySemVer)"
+      echo "LegacySemVerPadded: $(legacySemVerPadded)"
+      echo "AssemblySemVer: $(assemblySemVer)"
+      echo "AssemblySemFileVer: $(assemblySemFileVer)"
+      echo "FullSemVer: $(fullSemVer)"
+      echo "InformationalVersion: $(informationalVersion)"
+      echo "BranchName: $(branchName)"
+      echo "EscapedBranchName: $(escapedBranchName)"
+      echo "Sha: $(sha)"
+      echo "ShortSha: $(shortSha)"
+      echo "NuGetVersionV2: $(nuGetVersionV2)"
+      echo "NuGetVersion: $(nuGetVersion)"
+      echo "NuGetPreReleaseTagV2: $(nuGetPreReleaseTagV2)"
+      echo "NuGetPreReleaseTag: $(nuGetPreReleaseTag)"
+      echo "VersionSourceSha: $(versionSourceSha)"
+      echo "CommitsSinceVersionSource: $(commitsSinceVersionSource)"
+      echo "CommitsSinceVersionSourcePadded: $(commitsSinceVersionSourcePadded)"
+      echo "UncommittedChanges: $(uncommittedChanges)"
+      echo "CommitDate: $(commitDate)"
+
+  - displayName: Display GitVersion variables (with prefix)
+    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)"
+
+  - task: DotNetCoreCLI@2
+    displayName: Pack Example
+    inputs:
+      command: pack
+      packagesToPack: src/Example/LibExample.csproj
+      versioningScheme: byEnvVar
+      versionEnvVar: GitVersion_SemVer # alternative syntax GITVERSION_SEMVER (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
+jobs:
+  - 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
+jobs:
+  - 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,90 @@
+# 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
+ignoreFailedSources:
+  description: Treat package source failures as warnings.
+  required: false
+  default: false
+preferLatestVersion:
+  description: Prefer to download the latest version matching the versionSpec, even if there is a local cached version.
+  required: false
+  default: 'false'
+```
+
+---
+
+## Usage examples
+
+In order for the gitversion to properly work you need to clone the repository with the entire history:
+
+```yaml
+steps:
+  - checkout: self
+    fetchDepth: 0
+```
+
+### 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
+```
+
+### Example 4
+
+Install the latest GitVersion 5 version even it there is a cached version matching the versionSpec.
+
+```yaml
+steps:
+  - task: gitversion/setup@0
+    displayName: Install GitVersion
+    inputs:
+      versionSpec: '5.x'
+      preferLatestVersion: true
+```

docs/examples/github/gitreleasemanager/addasset.md

@@ -0,0 +1,15 @@
+# Example
+
+```yaml
+  steps:
+  - uses: gittools/actions/gitreleasemanager/addasset@v0
+    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
+    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@0
+    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
+    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
+    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
+    name: Publish release with GitReleaseManager
+    with:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      owner: 'someOwner'
+      repository: 'someRepository'
+      tagName: '0.1.0'
+```