(#2664) Add redirects for pages that have moved

gep13 · arturcic · commit 60e934b48819 · 2021-08-02T22:46:39.000+02:00
As a result of changes to the structure of the documentation site, the
original 301 redirects from readthedocs, were resulting in 404's within
GitHub pages. This PR addresses this by ensuring that a Wyam
RedirectFrom attribute is added to all affected pages, so that the end
result is arrive on the correct page.

There may be additional changes that need to be made to capture all
pages, but this commit contains all 301 redirects from the current
readthedocs configuration.
diff --git a/docs/input/docs/index.cshtml b/docs/input/docs/index.cshtml
@@ -1,5 +1,8 @@
 ---
 Title: Documentation
+RedirectFrom:
+ - docs/reference/pull-requests
+ - docs/reference/feature-branches
 ---
 
 @{
diff --git a/docs/input/docs/learn/branching-strategies/contribute-examples.md b/docs/input/docs/learn/branching-strategies/contribute-examples.md
@@ -2,6 +2,7 @@
 Order: 70
 Title: Contribute Examples
 Description: Contribute examples of how GitVersion works for your branching strategy
+RedirectFrom: docs/git-branching-strategies/creating-updating-examples
 ---
 
 The examples are generated by GitVersion tests, there are a number of services
diff --git a/docs/input/docs/learn/branching-strategies/gitflow/converting-to-gitflow.md b/docs/input/docs/learn/branching-strategies/gitflow/converting-to-gitflow.md
@@ -1,6 +1,7 @@
 ---
 Order: 60
 Title: Converting to GitFlow
+RedirectFrom: docs/git-branching-strategies/converting-to-gitflow
 ---
 
 Converting to GitFlow is simple. Whenever you need to convert, simply do the
diff --git a/docs/input/docs/learn/branching-strategies/gitflow/examples.md b/docs/input/docs/learn/branching-strategies/gitflow/examples.md
@@ -1,6 +1,9 @@
 ---
 Order: 40
 Title: GitFlow Examples
+RedirectFrom:
+- docs/git-branching-strategies/gitflow-examples_complete
+- docs/git-branching-strategies/gitflow-examples
 ---
 
 These examples are using the _default_ configuration with GitVersion. Which is
diff --git a/docs/input/docs/learn/branching-strategies/gitflow/index.md b/docs/input/docs/learn/branching-strategies/gitflow/index.md
@@ -2,6 +2,7 @@
 Order: 20
 Title: Git Flow
 Description: The Git Flow branching strategy allows for more structured releases
+RedirectFrom: docs/git-branching-strategies/gitflow
 ---
 
 Git Flow allows more structured releases, and GitVersion will derive sensible
diff --git a/docs/input/docs/learn/branching-strategies/githubflow/examples.md b/docs/input/docs/learn/branching-strategies/githubflow/examples.md
@@ -1,6 +1,7 @@
 ---
 Order: 50
 Title: GitHubFlow Examples
+RedirectFrom: docs/git-branching-strategies/githubflow-examples
 ---
 
 ## Feature branch
diff --git a/docs/input/docs/learn/branching-strategies/githubflow/index.md b/docs/input/docs/learn/branching-strategies/githubflow/index.md
@@ -2,6 +2,7 @@
 Order: 30
 Title: GitHub Flow
 Description: GitHub flow is a simpler and pull request-driven branching strategy
+RedirectFrom: docs/git-branching-strategies/githubflow
 ---
 
 GitHubFlow is a simple and effective branching strategy which the folks at
diff --git a/docs/input/docs/learn/branching-strategies/index.cshtml b/docs/input/docs/learn/branching-strategies/index.cshtml
@@ -2,6 +2,10 @@
 Order: 4000
 Title: Branching Strategies
 Description: Information about the different branching strategies supported by GitVersion
+RedirectFrom:
+- docs/git-branching-strategies/overview
+- docs/git-branching-strategies
+- docs/examples
 ---
 
 <img src="/docs/img/CommitGraph.png" alt="Commit graph">
diff --git a/docs/input/docs/learn/dynamic-repositories.md b/docs/input/docs/learn/dynamic-repositories.md
@@ -1,6 +1,7 @@
 ---
 Order: 20
 Title: Dynamic Repositories
+RedirectFrom: docs/more-info/dynamic-repositories
 ---
 
 GitVersion.exe requires access to the Git repository in order to do / infer all
diff --git a/docs/input/docs/learn/faq.md b/docs/input/docs/learn/faq.md
@@ -1,6 +1,7 @@
 ---
 Order: 50
 Title: FAQ
+RedirectFrom: docs/faq
 ---
 
 ## Why is my version not incrementing?
diff --git a/docs/input/docs/learn/git-setup.md b/docs/input/docs/learn/git-setup.md
@@ -1,6 +1,7 @@
 ---
 Order: 20
 Title: Git Setup
+RedirectFrom: docs/reference/git-setup
 ---
 
 ## Remotes
diff --git a/docs/input/docs/learn/how-it-works.md b/docs/input/docs/learn/how-it-works.md
@@ -1,6 +1,7 @@
 ---
 Order: 10
 Title: How it works
+RedirectFrom: docs/more-info/how-it-works
 ---
 
 GitVersion v3 works very differently to v2. Version 2 had knowledge of both
diff --git a/docs/input/docs/learn/index.cshtml b/docs/input/docs/learn/index.cshtml
@@ -2,6 +2,7 @@
 Title: Learn
 Description: More in depth information about GitVersion
 Order: 2000
+RedirectFrom: docs/more-info
 ---
 <p>Once you understand the basics of GitVersion, there are a number of lower level functions and configurations that you might want to make.  These are detailed in the following sections.</p>
 
diff --git a/docs/input/docs/learn/intro-to-semver.md b/docs/input/docs/learn/intro-to-semver.md
@@ -1,6 +1,7 @@
 ---
 Order: 10
 Title: Intro to SemVer
+RedirectFrom: docs/reference/intro-to-semver
 ---
 
 For the official Semantic Version docs head to [semver.org](http://semver.org). This is just a quick guide for people  getting started and how SemVer is used in GitVersion.
diff --git a/docs/input/docs/learn/who.md b/docs/input/docs/learn/who.md
@@ -1,6 +1,7 @@
 ---
 Order: 70
 Title: Who is using GitVersion
+RedirectFrom: docs/who
 ---
 
 Various people are actively using GitVersion, and taking advantage of the
diff --git a/docs/input/docs/learn/why.md b/docs/input/docs/learn/why.md
@@ -1,6 +1,7 @@
 ---
 Order: 60
 Title: Why use GitVersion?
+RedirectFrom: docs/why
 ---
 
 GitVersion makes versioning woes a thing of the past. It looks at your git
diff --git a/docs/input/docs/reference/build-servers/appveyor.md b/docs/input/docs/reference/build-servers/appveyor.md
@@ -2,6 +2,7 @@
 Order: 10
 Title: AppVeyor
 Description: Details on the AppVeyor support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/appveyor
 ---
 
 AppVeyor is the first build server which has a setup helper built into
diff --git a/docs/input/docs/reference/build-servers/azure-devops.md b/docs/input/docs/reference/build-servers/azure-devops.md
@@ -4,6 +4,7 @@ Title: Azure DevOps
 Description: |
     Details on the Azure DevOps or Team Foundation Server Build Pipeline support
     in GitVersion
+RedirectFrom: docs/build-server-support/build-server/azure-devops
 ---
 
 ## Basic Usage
diff --git a/docs/input/docs/reference/build-servers/bamboo.md b/docs/input/docs/reference/build-servers/bamboo.md
@@ -2,6 +2,7 @@
 Order: 30
 Title: Bamboo
 Description: Details on the Bamboo support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/bamboo
 ---
 
 If you use Bamboo then you will have to use GitVersion from the command line, as
diff --git a/docs/input/docs/reference/build-servers/continua.md b/docs/input/docs/reference/build-servers/continua.md
@@ -2,6 +2,7 @@
 Order: 40
 Title: Continua CI
 Description: Details on the Continua CI support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/continua
 ---
 
 This guide explains how to run GitVersion inside [Continua CI](https://www.finalbuilder.com/continua-ci).
diff --git a/docs/input/docs/reference/build-servers/gitlab.md b/docs/input/docs/reference/build-servers/gitlab.md
@@ -2,6 +2,7 @@
 Order: 50
 Title: GitLab CI
 Description: Details on the GitLab CI support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/gitlab
 ---
 
 To use GitVersion with GitLab CI, either use the [MSBuild
diff --git a/docs/input/docs/reference/build-servers/index.cshtml b/docs/input/docs/reference/build-servers/index.cshtml
@@ -1,6 +1,12 @@
 ---
 Order: 3000
 Description: Details on GitVersion's Build Server support
+RedirectFrom:
+- docs/build-server-support
+- docs/build-server-support/build-server
+- docs/build-server-support/build-server/index.html
+- docs/build-server-support/build-server-support
+- docs/build-server-support/index.html
 ---
 
 <p>
diff --git a/docs/input/docs/reference/build-servers/jenkins.md b/docs/input/docs/reference/build-servers/jenkins.md
@@ -2,6 +2,7 @@
 Order: 60
 Title: Jenkins
 Description: Details on the Jenkins support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/jenkins
 ---
 
 ## SCM Settings
diff --git a/docs/input/docs/reference/build-servers/myget.md b/docs/input/docs/reference/build-servers/myget.md
@@ -2,6 +2,7 @@
 Order: 70
 Title: MyGet
 Description: Details on the MyGet support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/myget
 ---
 
 MyGet Build Services has built-in support for GitVersion and is encouraging you
diff --git a/docs/input/docs/reference/build-servers/octopus-deploy.md b/docs/input/docs/reference/build-servers/octopus-deploy.md
@@ -2,6 +2,7 @@
 Order: 80
 Title: Octopus Deploy
 Description: Details on the Octopus Deploy support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/octopus-deploy
 ---
 
 While not a build server, there are a few things to consider when using Octopus
diff --git a/docs/input/docs/reference/build-servers/teamcity.md b/docs/input/docs/reference/build-servers/teamcity.md
@@ -2,6 +2,7 @@
 Order: 90
 Title: TeamCity
 Description: Details on the TeamCity support in GitVersion
+RedirectFrom: docs/build-server-support/build-server/teamcity
 ---
 
 ## Basic Usage
diff --git a/docs/input/docs/reference/configuration.md b/docs/input/docs/reference/configuration.md
@@ -2,6 +2,7 @@
 Order: 10
 Title: Configuration
 Description: Details about how GitVersion can be configured to suit your needs
+RedirectFrom: docs/configuration
 ---
 
 GitVersion from version 3 is mainly powered by configuration and no longer has
diff --git a/docs/input/docs/reference/modes/continuous-delivery.md b/docs/input/docs/reference/modes/continuous-delivery.md
@@ -5,6 +5,7 @@ Description: |
     Continuous Delivery is the default versioning mode. In this mode,
     GitVersion calculates the next version and will use that until that is
     released.
+RedirectFrom: docs/reference/versioning-modes/continuous-delivery
 ---
 
 Continuous Delivery is the practice of having a deployment pipeline and is the
diff --git a/docs/input/docs/reference/modes/continuous-deployment.md b/docs/input/docs/reference/modes/continuous-deployment.md
@@ -4,6 +4,7 @@ Title: Continuous Deployment
 Description: |
     Sometimes you just want the version to keep changing and deploy continuously.
     In this case, Continuous Deployment is a good mode to operate GitVersion by.
+RedirectFrom: docs/reference/versioning-modes/continuous-deployment
 ---
 
 Continuous Deployment is the process of checking into main, running all the
diff --git a/docs/input/docs/reference/modes/index.cshtml b/docs/input/docs/reference/modes/index.cshtml
@@ -2,6 +2,7 @@
 Order: 50
 Title: Versioning Modes
 Description: The different modes of versioning GitVersion supports
+RedirectFrom: docs/reference/versioning-modes/versioning-mode
 ---
 
 <p>
diff --git a/docs/input/docs/reference/modes/mainline.md b/docs/input/docs/reference/modes/mainline.md
@@ -5,6 +5,7 @@ Description: |
     Mainline Development versioning mode works like the Continuous Delivery,
     except that it tells GitVersion to *infer* releases from merges and commits
     to `main`.
+RedirectFrom: docs/reference/versioning-modes/mainline-development
 ---
 
 Mainline Development is enabled when using [GitHubFlow][githubflow] or any other
diff --git a/docs/input/docs/reference/variables.md b/docs/input/docs/reference/variables.md
@@ -2,6 +2,7 @@
 Order: 20
 Title: Version Variables
 Description: The version variables exposed by GitVersion
+RedirectFrom: docs/more-info/variables
 ---
 
 Version variables are quite useful if you need different formats of the version
diff --git a/docs/input/docs/reference/version-increments.md b/docs/input/docs/reference/version-increments.md
@@ -2,6 +2,9 @@
 Order: 40
 Title: Version Incrementing
 Description: Details on how GitVersion performs version increments
+RedirectFrom:
+- docs/more-info/incrementing-per-commit
+- docs/more-info/version-increments
 ---
 
 Because GitVersion works with several workflows, the way it does its version
diff --git a/docs/input/docs/reference/version-sources.md b/docs/input/docs/reference/version-sources.md
@@ -2,6 +2,7 @@
 Order: 50
 Title: Version Sources
 Description: Details on how GitVersion finds a source for its generated version number
+RedirectFrom: docs/more-info/version-sources
 ---
 
 GitVersion has a two step process for calculating the version number. First it
diff --git a/docs/input/docs/usage/cli/index.cshtml b/docs/input/docs/usage/cli/index.cshtml
@@ -5,6 +5,7 @@ Description: |
     The Command Line gives most flexibility by allowing the execution of
     GitVersion to be customized
 CardIcon: terminal.svg
+RedirectFrom: docs/usage/command-line
 ---
 
 <p>
diff --git a/docs/input/docs/usage/index.cshtml b/docs/input/docs/usage/index.cshtml
@@ -4,6 +4,9 @@ Description: |
     There are four different ways to consume GitVersion itself. You can find
     each of these options below.
 Order: 1
+RedirectFrom:
+- docs/usage/gem
+- docs/usage/usage
 ---
 
 <p>@Html.Raw(Model.String(DocsKeys.Description))</p>
diff --git a/docs/input/docs/usage/library.md b/docs/input/docs/usage/library.md
@@ -6,6 +6,7 @@ Description: |
     is an unsupported option and the API may break even between minor or
     patch releases, it's a useful option to some.
 CardIcon: library.svg
+RedirectFrom: docs/usage/nuget-library
 ---
 
 Install with NuGet and use GitVersion as a software library. Although this
diff --git a/docs/input/docs/usage/msbuild.md b/docs/input/docs/usage/msbuild.md
@@ -5,6 +5,7 @@ Description: |
     Just install with NuGet and GitVersion will automatically generate assembly
     version information that is compiled into the resulting artifact.
 CardIcon: collect.svg
+RedirectFrom:  docs/usage/msbuild-task
 ---
 
 The MSBuild Task for GitVersion — **GitVersion.MsBuild** — is a simple solution if
