docs: update writing mdx

Author: rakannimer

src/docs/documentation/general/writing-mdx.mdx

@@ -15,9 +15,11 @@ More details about MDX in the [Official website.](https://mdxjs.com/)
 ## Working with components
 
 For now, you only need to know that with MDX you can use your components inside markdown.
-But how? Let's take a look at how we can improve our `.mdx` created before by importing and using a component inside it. The example below assumes we have a exported component named `Button` in a file named `Button.jsx`/`Button.tsx` located in the same folder as the `.mdx`-file we are editing.
+But how? Let's take a look at how we can improve our `.mdx` file created previously by importing and using a component inside it. 
 
-```markdown
+The example below assumes we have an exported component named `Button` in a file named `Button.jsx`/`Button.tsx` located in the same folder as the `.mdx` file we are editing.
+
+```mdx
 ---
 name: Hello world
 ---
@@ -26,17 +28,16 @@ import { Button } from './Button'
 
 # Hello world
 
-Hello, I'm still a mdx file, but now I have a button component!
+Hello, I'm still a mdx file, but now I have a button component !
 
-<Button>Click</Button>
+<Button onClick={() => { alert("You clicked me"); }}>Click me</Button>
 ```
 
-And, if you really have a `Button` component to import, you'll see something like this:
+And, if you do have a `Button` component to import, you'll see something like this:
+
+![Documentation site showing a rendered button along with Markdown](https://cdn-std.dprcdn.net/files/acc_649651/Fgbg4F)
 
-![](https://cdn-std.dprcdn.net/files/acc_649651/Fgbg4F)
+With MDX you can mix _React Components_ or _html-elements_ with regular markdown allowing you to either document your own components _or_ create helper components that make documentation easier. 
 
-With MDX you can mix _React Components_ or _html-elements_ with regular markdown allowing you to either document your own components _or_ creating helper components that makes documentation easier. **Docz** comes with some prebuilt helper components which will help you document components faster, these are covered in [**Built-in components**](/docs/built-in-components).
+**Docz** comes with some helper components that will help you document your components faster, these are covered in [**Built-in components**](/docs/built-in-components).
 
-> ### Note
->
-> So far Docz only works with React components. But stay calm, we are working to bring Preact, Vue and some others libraries to Docz!