From 143cd1d6b46930ae5bb73aff7ae7ef6ffb74268c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Asbj=C3=B8rn=20Ulsberg?= Date: Fri, 25 Sep 2020 12:12:44 +0200 Subject: [PATCH] Rename setup.md to index.md in preparation for merge of content --- README.md | 87 ++----------------- .../azure/gitversion/{setup.md => index.md} | 0 .../github/gitversion/{setup.md => index.md} | 0 3 files changed, 8 insertions(+), 79 deletions(-) rename docs/examples/azure/gitversion/{setup.md => index.md} (100%) rename docs/examples/github/gitversion/{setup.md => index.md} (100%) diff --git a/README.md b/README.md index 563ed18..b78214b 100644 --- a/README.md +++ b/README.md @@ -12,87 +12,16 @@ GitHub Actions that allow to install and use the [GitVersion](https://github.com ## Usage -see examples of usages for **GitVersion**: +### GitVersion -- [GitHub Actions](docs/examples/github/gitversion) -- [Azure Pipeline tasks](docs/examples/azure/gitversion) +Examples for usage of **GitVersion**: -and for **GitReleaseManager**: +- [GitHub Actions](docs/examples/github/gitversion/) +- [Azure Pipeline tasks](docs/examples/azure/gitversion/) + +### GitReleaseManager + +Examples for usage of **GitReleaseManager**: - [GitHub Actions](docs/examples/github/gitreleasemanager) - [Azure Pipeline tasks](docs/examples/azure/gitreleasemanager) - -## Dependency - -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. - -```yaml - steps: - - name: Checkout - uses: actions/checkout@v2 - - name: Fetch all history for all tags and branches - run: git fetch --prune --unshallow -``` - -Basic: - -```yaml - steps: - - name: Checkout - uses: actions/checkout@v2 - - name: Fetch all history for all tags and branches - run: git fetch --prune --unshallow - - name: Install GitVersion - uses: gittools/actions/gitversion/setup@v0.9.2 - with: - versionSpec: '5.2.x' - - name: Use GitVersion - id: gitversion # step id used as reference for output values - uses: gittools/actions/gitversion/execute@v0.9.2 - - run: | - echo "Major: ${{ steps.gitversion.outputs.major }}" - echo "Minor: ${{ steps.gitversion.outputs.minor }}" - echo "Patch: ${{ steps.gitversion.outputs.patch }}" - echo "PreReleaseTag: ${{ steps.gitversion.outputs.preReleaseTag }}" - echo "PreReleaseTagWithDash: ${{ steps.gitversion.outputs.preReleaseTagWithDash }}" - echo "PreReleaseLabel: ${{ steps.gitversion.outputs.preReleaseLabel }}" - echo "PreReleaseNumber: ${{ steps.gitversion.outputs.preReleaseNumber }}" - echo "WeightedPreReleaseNumber: ${{ steps.gitversion.outputs.weightedPreReleaseNumber }}" - echo "BuildMetaData: ${{ steps.gitversion.outputs.buildMetaData }}" - echo "BuildMetaDataPadded: ${{ steps.gitversion.outputs.buildMetaDataPadded }}" - echo "FullBuildMetaData: ${{ steps.gitversion.outputs.fullBuildMetaData }}" - echo "MajorMinorPatch: ${{ steps.gitversion.outputs.majorMinorPatch }}" - echo "SemVer: ${{ steps.gitversion.outputs.semVer }}" - echo "LegacySemVer: ${{ steps.gitversion.outputs.legacySemVer }}" - echo "LegacySemVerPadded: ${{ steps.gitversion.outputs.legacySemVerPadded }}" - echo "AssemblySemVer: ${{ steps.gitversion.outputs.assemblySemVer }}" - echo "AssemblySemFileVer: ${{ steps.gitversion.outputs.assemblySemFileVer }}" - echo "FullSemVer: ${{ steps.gitversion.outputs.fullSemVer }}" - echo "InformationalVersion: ${{ steps.gitversion.outputs.informationalVersion }}" - echo "BranchName: ${{ steps.gitversion.outputs.branchName }}" - echo "Sha: ${{ steps.gitversion.outputs.sha }}" - echo "ShortSha: ${{ steps.gitversion.outputs.shortSha }}" - echo "NuGetVersionV2: ${{ steps.gitversion.outputs.nuGetVersionV2 }}" - echo "NuGetVersion: ${{ steps.gitversion.outputs.nuGetVersion }}" - echo "NuGetPreReleaseTagV2: ${{ steps.gitversion.outputs.nuGetPreReleaseTagV2 }}" - echo "NuGetPreReleaseTag: ${{ steps.gitversion.outputs.nuGetPreReleaseTag }}" - echo "VersionSourceSha: ${{ steps.gitversion.outputs.versionSourceSha }}" - echo "CommitsSinceVersionSource: ${{ steps.gitversion.outputs.commitsSinceVersionSource }}" - echo "CommitsSinceVersionSourcePadded: ${{ steps.gitversion.outputs.commitsSinceVersionSourcePadded }}" - echo "CommitDate: ${{ steps.gitversion.outputs.commitDate }}" - -``` - -### Private Repositories - -Private repos require credentials before you can fetch the master branch and tags. - -```yaml - steps: - - name: Checkout - uses: actions/checkout@v2 - - name: Fetch all history for all tags and branches - run: | - git config remote.origin.url https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }} - git fetch --prune --unshallow -``` diff --git a/docs/examples/azure/gitversion/setup.md b/docs/examples/azure/gitversion/index.md similarity index 100% rename from docs/examples/azure/gitversion/setup.md rename to docs/examples/azure/gitversion/index.md diff --git a/docs/examples/github/gitversion/setup.md b/docs/examples/github/gitversion/index.md similarity index 100% rename from docs/examples/github/gitversion/setup.md rename to docs/examples/github/gitversion/index.md