Merge pull request #220 from DeepLcom/199-improve-docs-for-context-param

add in new context parameter guide

Author: shirgoldbird

api-reference/translate.mdx

@@ -9,7 +9,7 @@ The text-translation API currently consists of a single endpoint, `translate`, w
 
 For highest translation quality, we recommend using our next-gen models. For details, please see [here](/docs/api-reference/translate#about-the-model-type-parameter).
 
-To learn more about context in DeepL API translations, we recommend [this article](/docs/best-practices/working-with-context).
+To learn more about context in DeepL API translations, see our [context parameter guide](/docs/learning-how-tos/how-to-use-context-parameter).
 
 For more detail about request body parameters, see the [Request Body Descriptions](/api-reference/translate#request-body-descriptions) section further down on the page.
 

docs.json

@@ -55,7 +55,6 @@
                 "pages": [
                   "docs/learning-how-tos/cookbook",
                   "docs/learning-how-tos/cookbook/google-sheets",
-                  "docs/learning-how-tos/cookbook/context-parameter-examples",
                   "docs/learning-how-tos/cookbook/automating-indie-game-localization-with-the-deepl-api-and-godot",
                   "docs/learning-how-tos/cookbook/java-document-translator",
                   "docs/learning-how-tos/cookbook/usage-analytics-dashboard"
@@ -65,6 +64,7 @@
                 "group": "Guides",
                 "pages": [
                   "docs/learning-how-tos/examples-and-guides/",
+                  "docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter",
                   "docs/learning-how-tos/examples-and-guides/placeholder-tags",
                   "docs/learning-how-tos/examples-and-guides/first-things-to-try-with-the-deepl-api",
                   "docs/learning-how-tos/examples-and-guides/glossaries-in-the-real-world",
@@ -79,7 +79,6 @@
               "docs/best-practices/error-handling",
               "docs/best-practices/cors-requests",
               "docs/best-practices/document-translations",
-              "docs/best-practices/working-with-context",
               "docs/best-practices/language-detection",
               "docs/best-practices/cost-control",
               "docs/best-practices/pre-production-checklist"
@@ -394,6 +393,14 @@
     {
       "source": "/api-reference/voice/reconnect-stream",
       "destination": "/api-reference/voice/reconnect-session"
+    },
+    {
+      "source": "/docs/best-practices/working-with-context",
+      "destination": "/docs/learning-how-tos/how-to-use-context-parameter"
+    },
+    {
+      "source": "/docs/learning-how-tos/cookbook/context-parameter-examples",
+      "destination": "/docs/learning-how-tos/how-to-use-context-parameter"
     }
   ],
   "integrations": {

docs/best-practices/working-with-context.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Guides"
 sidebarTitle: "Overview"
-description:  "A collection of guides for addressing common issues with the DeepL API."
+description:  "Learn how to use DeepL API features to achieve your translation goals."
 public: true
 ---
 <CardGroup cols={2}>
@@ -18,5 +18,8 @@ public: true
 
   Written by [Akash Joshi](https://thewriting.dev)
 
+  </Card>
+  <Card title="How to Use the Context Parameter Effectively" horizontal href="/docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter">
+    
   </Card>
 </CardGroup>