API reference: use /api as path and config as redirect (#5272)

Author: chalin

.htmltest.yml

@@ -12,6 +12,7 @@ IgnoreDirs:
   - zh/docs/contributing/pr-checks
 IgnoreInternalURLs: # list of paths
 IgnoreURLs: # list of regexs of paths or URLs to be ignored
+  - ^/api$
   - ^((/..)?/docs/languages/\w+|\.\.)/(api|examples|registry)/$
   - ^(/..)?/docs/collector/registry/$
   - ^(/..)?/docs/languages/net/(metrics-api|traces-api)/

content/en/api-docs.md

@@ -0,0 +1,8 @@
+---
+title: API references
+linkTitle: API
+redirect: /docs/languages/#api-references
+manualLinkTarget: _blank
+_build: { render: link }
+aliases: [api-docs]
+---

content/en/api.md

@@ -48,9 +48,9 @@ references are available:
 
 {{% apidocs %}}
 
-{{% alert title="Tip" color="info" %}}
+{{% alert title="Note" color="info" %}}
 
-You can find a list of available API references at </api-docs>.
+The list above is aliased to [`/api`](/api).
 
 {{% /alert %}}