Add basic translation guide, fix some PHP issues elsewhere

Author: morsssss

api-reference/translate.mdx

@@ -110,7 +110,7 @@ print(result.text)  # "Bonjour, le monde !"
 <Tab title="PHP">
 ```php Example request: text translation (without glossary)
 $authKey = "f63c02c5-f056-..."; // Replace with your key
-$deeplClient = new \DeepL\DeepLClient($authKey);
+$deeplClient = new DeepL\DeepLClient($authKey);
 
 $result = $deeplClient->translateText('Hello, world!', null, 'fr');
 echo $result->text; // Bonjour, le monde!

docs.json

@@ -72,12 +72,13 @@
               {
                 "group": "Guides",
                 "pages": [
-                  "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/translation-beginners-guide",
+                  "docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter",
+                  "docs/learning-how-tos/examples-and-guides/translating-between-variants",
                   "docs/learning-how-tos/examples-and-guides/glossaries-in-the-real-world",
-                  "docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications",
-                  "docs/learning-how-tos/examples-and-guides/translating-between-variants"
+                  "docs/learning-how-tos/examples-and-guides/placeholder-tags",
+                  "docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications"
                 ]
               }
             ]

docs/getting-started/intro.mdx

@@ -142,10 +142,10 @@ New user? Follow these quick steps to get started with the DeepL API.
 
         ```php Sample request
         require_once 'vendor/autoload.php';
-        use DeepL\Translator;
+        use DeepL\Client;
 
         $authKey = "{YOUR_API_KEY}"; // replace with your key
-        $deeplClient = new \DeepL\DeepLClient($authKey);
+        $deeplClient = new DeepL\DeepLClient($authKey);
 
         $result = $deeplClient->translateText('Hello, world!', null, 'de');
         echo $result->text;

docs/getting-started/your-first-api-request.mdx

@@ -104,10 +104,10 @@ We included text translation examples for our [client libraries](/docs/getting-s
   <Tab title="PHP">
     ```php
     require_once 'vendor/autoload.php';
-    use DeepL\Translator;
+    use DeepL\Client;
 
     $authKey = "f63c02c5-f056-..."; // Replace with your key
-    $deeplClient = new \DeepL\DeepLClient($authKey);
+    $deeplClient = new DeepL\DeepLClient($authKey);
 
     $result = $deeplClient->translateText('Hello, world!', null, 'fr');
     echo $result->text; // Bonjour, le monde!

docs/learning-how-tos/examples-and-guides.mdx

@@ -5,24 +5,21 @@ description:  "Learn how to use DeepL API features to achieve your translation g
 public: true
 ---
 <CardGroup cols={2}>
-  <Card title="Mustache placeholder tags" horizontal href="/docs/learning-how-tos/examples-and-guides/placeholder-tags">
-    
-  </Card>
   <Card title="DeepL API 101" horizontal href="/docs/learning-how-tos/examples-and-guides/first-things-to-try-with-the-deepl-api">
-    
+  </Card>
+  <Card title="Translation: a beginner's guide" horizontal href="/docs/learning-how-tos/examples-and-guides/translation-beginners-guide">    
+  </Card>
+  <Card title="Mustache placeholder tags" horizontal href="/docs/learning-how-tos/examples-and-guides/placeholder-tags">    
   </Card>
   <Card title="Glossaries in the real world" horizontal href="/docs/learning-how-tos/examples-and-guides/glossaries-in-the-real-world">
-    
   </Card>
   <Card title="DeepL MCP Server: How to Build and Use Translation in LLM Applications" horizontal href="/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications">
 
   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>
   <Card title="How to Translate Between Language Variants" horizontal href="/docs/learning-how-tos/examples-and-guides/translating-between-variants">
-    
   </Card>
 </CardGroup>