docs: remove API Reference overview pages, fold into endpoints

api-reference/languages/retrieve-languages-by-resource.mdx

@@ -1,5 +1,11 @@
 ---
 openapi: get /v3/languages
 title: "Retrieve languages"
+description: "Retrieve supported languages and feature availability for a specific DeepL API resource."
 ---
 
+Returns the languages supported for a given DeepL API resource, along with feature availability per language (such as formality, glossary support, transcription, and writing style).
+
+Use the `resource` query parameter to filter results by API product. Supported values include `translate_text`, `translate_document`, `glossary`, `write`, and `voice`.
+
+This endpoint replaces the deprecated [`GET /v2/languages`](/api-reference/languages/retrieve-supported-languages) endpoint. See the [migration guide](/api-reference/languages/migrate-from-v2-languages) for details.

api-reference/translate/request-translation.mdx

@@ -1,5 +1,5 @@
 ---
 openapi: post /v2/translate
 title: "Translate text"
-description: ""
+description: "Translate one or more text strings into a target language."
 ---

docs.json

@@ -94,6 +94,12 @@
               "docs/retrieving-usage-data"
             ]
           },
+          {
+            "group": "learning-how-tos",
+            "pages": [
+              "docs/learning-how-tos/examples-and-guides/translating-text"
+            ]
+          },
           {
             "group": "Going to Production",
             "pages": [
@@ -159,7 +165,6 @@
               {
                 "group": "Translate Text",
                 "pages": [
-                  "api-reference/translate",
                   "api-reference/translate/request-translation"
                 ],
                 "drilldown": false
@@ -345,8 +350,14 @@
       {
         "title": "Resources",
         "items": [
-          { "label": "API Status", "href": "https://api-status.deepl.com" },
-          { "label": "DeepL Status", "href": "https://www.deeplstatus.com" }
+          {
+            "label": "API Status",
+            "href": "https://api-status.deepl.com"
+          },
+          {
+            "label": "DeepL Status",
+            "href": "https://www.deeplstatus.com"
+          }
         ]
       }
     ],
@@ -359,7 +370,9 @@
   },
   "api": {
     "examples": {
-      "languages": ["curl"],
+      "languages": [
+        "curl"
+      ],
       "defaults": "required"
     },
     "playground": {
@@ -576,4 +589,4 @@
       }
     }
   ]
-}
+}