Finished improving designers docs

1 files changed, 19 insertions, 14 deletions

diff --git a/docs/designers/language-modifiers/language-modifier-cat.md b/docs/designers/language-modifiers/language-modifier-cat.md
index 1f43ae17..97dda4b3 100644
--- a/docs/designers/language-modifiers/language-modifier-cat.md
+++ b/docs/designers/language-modifiers/language-modifier-cat.md
@@ -1,31 +1,36 @@
-cat {#language.modifier.cat}
-===
+# cat
 
 This value is concatenated to the given variable.
 
-   Parameter Position    Type    Required   Default  Description
-  -------------------- -------- ---------- --------- -----------------------------------------------
-           1            string      No      *empty*  This value to catenate to the given variable.
+## Basic usage
+```smarty
+{$myVar|cat:' units'}
+```
 
+## Parameters
 
-    <?php
+| Parameter | Type   | Required | Description                                      |
+|-----------|--------|----------|--------------------------------------------------|
+| 1         | string | No       | This value to concatenate to the given variable. |
 
-    $smarty->assign('articleTitle', "Psychics predict world didn't end");
+## Examples
 
-    ?>
+```php
+<?php
 
-       
+    $smarty->assign('articleTitle', "Psychics predict world didn't end");
 
-Where template is:
+```
 
+Where template is:
 
+```smarty
     {$articleTitle|cat:' yesterday.'}
-
-       
+```
 
 Will output:
 
-
+```
     Psychics predict world didn't end yesterday.
-
+```