bring changes from #878

Author: ethanpalm

components/code-groups.mdx

@@ -1,12 +1,10 @@
 ---
 title: "Code groups"
-description: "The CodeGroup component lets you combine code blocks in a display separated by tabs"
+description: "Display multiple code examples in one component"
 icon: "group"
 ---
 
-You will need to make [Code Blocks](/code) then add the `<CodeGroup>` component around them. Every Code Block must have a filename because we use the names for the tab buttons.
-
-See below for an example of the end result.
+Use the `CodeGroup` component to display multiple code blocks in a tabbed interface, allowing users to compare implementations across different programming languages or see alternative approaches for the same task.
 
 <CodeGroup>
 
@@ -28,11 +26,12 @@ class HelloWorld {
 
 </CodeGroup>
 
-## Language dropdown
+## Creating code groups
 
-You can replace the tabs in a code group with a dropdown menu to toggle between languages using the `dropdown` prop.
+To create a code group, wrap multiple code blocks with `<CodeGroup>` tags. Each code block must include a title, which becomes the tab label.
 
-<CodeGroup dropdown>
+````mdx
+<CodeGroup>
 
 ```javascript helloWorld.js
 console.log("Hello World");
@@ -51,9 +50,12 @@ class HelloWorld {
 ```
 
 </CodeGroup>
+````
 
+## Language dropdown
+
+You can replace the tabs in a code group with a dropdown menu to toggle between languages using the `dropdown` prop.
 
-````mdx highlight=1
 <CodeGroup dropdown>
 
 ```javascript helloWorld.js
@@ -71,14 +73,11 @@ class HelloWorld {
     }
 }
 ```
-</CodeGroup>
-````
-
 
-<RequestExample>
+</CodeGroup>
 
-````mdx Code Group Example
-<CodeGroup>
+````mdx highlight=1
+<CodeGroup dropdown>
 
 ```javascript helloWorld.js
 console.log("Hello World");
@@ -95,8 +94,5 @@ class HelloWorld {
     }
 }
 ```
-
 </CodeGroup>
 ````
-
-</RequestExample>