> [!NOTE]
> **Note:** Shortlinks on fuchsia.dev (fuchsia.dev/go/keyword) were implemented based on [RFC-0125](https://fuchsia.dev/docs/contribute/governance/rfcs/0125_shortlink_fuchsia_dev).

## Create a shortlink

Before you create a shortlink, review the shortlink [rubric](https://fuchsia.dev/docs/contribute/docs/shortlinks/rubric) to determine if
your shortlink proposal meets the requirements.

1. Review the [`/docs/go/_redirects.yaml`](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/go/_redirects.yaml) file to make sure that the proposed keyword doesn't already exist.
2. If the keyword is available, append the following to
   [`/docs/go/_redirects.yaml`](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/go/_redirects.yaml):

   > [!NOTE]
   > **Note:** You can use the [GIT source editor](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/go/_redirects.yaml) to propose a shortlink from a browser.

       - from: /docs/go/keyword
         to: /docs/path_of_shortlink

3. Send your change for review.

4. Add a shortlink reviewer to review your change.

   > [!NOTE]
   > **Note:** [See a list of available reviewers](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/go/OWNERS).

If your proposal is rejected, a reviewer will list the reason for the
rejection and include a rationale.

If your proposal is approved, you may submit your shortlink. Once the change
is rolled into the build, the shortlink will go live on fuchsia.dev. The link
will resolve at both `fuchsia.dev/go/<keyword>` and
`fuchsia.dev/fuchsia-src/go/<keyword>`.

## Become a reviewer

Reviewers are expected to meet the following criteria:

- Reviewers must be knowledgeable about Fuchsia. Typically,
  contributors acquire this knowledge by working on the project for a
  substantial amount of time and by interacting with multiple parts of the
  system.

- Reviewers must enforce the shortlink criteria detailed in the [rubric](https://fuchsia.dev/docs/contribute/docs/shortlinks/rubric).

If you meet the review criteria, you can create a change to propose yourself
as a member by editing the [OWNERS](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/go/OWNERS) file of the `/docs/go/` directory.
[](https://issues.fuchsia.dev/issues/new?component=1439230&template=1881640&description=Issue+on:+https://fuchsia.dev/docs/contribute/docs/shortlinks/README.md "Report a bug or suggest improvements on this page") [](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/contribute/docs/shortlinks/README.md "View the source code of this page") [](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/contribute/docs/shortlinks/README.md&cloneRepo=fuchsia/fuchsia:refs/heads/main&fullPath=fuchsia/docs/contribute/docs/shortlinks/README.md "Edit the source code of this page")