Merge pull request #11460 from thaJeztah/go_reserve

Reserve "/go/" URL prefix for redirect pages
This commit is contained in:
Sebastiaan van Stijn 2020-10-05 10:06:04 +02:00 committed by GitHub
commit bb8d5d99c6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 0 deletions

19
go/about.md Normal file
View File

@ -0,0 +1,19 @@
---
description: Docker documentation redirect URLs
title: Docker documentation redirect URLs
published: false
---
This page is used to reserve the "/go/" URL/path for redirecting purposes. This
page is not published, and should not be visible on the documentation website.
Use the `/go/` URL prefix to provide "vanity" URLs linking to the documentation.
These URLs can be used in (for example) the `docker` CLI to provide a short,
permanent link to refer to a topic in the documentation.
Having a fixed `/go/` URL allows you to redirect the URL to the most current
location in the documentation for a given topic, which may evolve over time.
For example, the `docker` CLI can output `https://docs.docker.com/go/some-topic`
in its help output, which can be redirected to elsewhere in the documentation,
using the `redirect_from` metadata field in the target page.