WIP: reference: show aliases for commands

[thaJeztah]

• relates to Reference docs: use canonical URL / command names #10471
• relates to Reference docs: use canonical URL / command names #10471 (comment)

Proposed changes

Related issues (optional)

[netlify]

✅ Deploy Preview for docsdocker ready!

Name	Link
🔨 Latest commit	8004050
🔍 Latest deploy log	https://app.netlify.com/sites/docsdocker/deploys/6482e59595028b00080e8662
😎 Deploy Preview	https://deploy-preview-17511--docsdocker.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[thaJeztah]

I constructed the URLs for each alias here, but this won't work because we don't have redirects for all aliases.

Some options;

• (for now) just show the aliases only (without a link)
• add redirects for all aliases
• ^^^ but if we do, we need to update those redirects to the canonical URL once we moved the content (see Reference docs: use canonical URL / command names #10471 and [WIP] reorganise reference docs cli#2389)
• ^^^ if we add redirects now, those would already have a "moved permanently" redirect, so I'm not sure if it's a good idea to do that if we'll be updating the location in future (SEO-wise)

[thaJeztah]

Also, this list does not filter out the "current" page from the list; perhaps that's what we want, or perhaps we want to exclude the "current alias" here (not sure what's best)

I should add here tha

• (if I did it right everywhere), the first "alias" in the list is considered the "canonical", and ultimately should be the page we redirect them all to, but content would still have to be moved (and we need to review if all those are indeed what we consider the "canonical")
• "build" is still a tricky one; docker image build is probably the canonical one, but docker buildx build can in some cases provide additional options / ever-so-slightly different behavior, so may not be an "exact" alias.
• ^^ documentation is also still spread between docker build and docker buildx build

[docker-robot]

Thanks for the pull request. We'd like to make our product docs better, but haven’t been able to review all the suggestions.
As our docs have also diverged, we do not have the bandwidth to review and rebase old pull requests.

If the updates are still relevant, review our contribution guidelines and rebase your pull request against the latest version of the docs, then mark it as fresh with a /remove-lifecycle stale comment.
If not, this pull request will be closed in 30 days. This helps our maintainers focus on the active pull requests.

Prevent pull requests from auto-closing with a /lifecycle frozen comment.

/lifecycle stale

[docker-robot]

Thanks for the pull request. We'd like to make our product docs better, but haven’t been able to review all the suggestions.
As our docs have also diverged, we do not have the bandwidth to review and rebase old pull requests.

If the updates are still relevant, review our contribution guidelines and rebase your pull request against the latest version of the docs, then mark it as fresh with a /remove-lifecycle stale comment.
If not, this pull request will be closed in 30 days. This helps our maintainers focus on the active pull requests.

Prevent pull requests from auto-closing with a /lifecycle frozen comment.

/lifecycle stale