diff --git a/docs/pattern-pseudo-patterns.md b/docs/pattern-pseudo-patterns.md
index c8056aa..25120a1 100644
--- a/docs/pattern-pseudo-patterns.md
+++ b/docs/pattern-pseudo-patterns.md
@@ -59,3 +59,7 @@ Now when we generate our site we'll have our homepage template rendered twice. O
 By default, pseudo-patterns **cannot** be used as pattern includes. The data included in the pseudo-pattern, the bit that actually controls the magic, cannot be accessed when rendering the pattern include.
 
 To utilize pseudo-patterns as pattern includes for the PHP version of Pattern Lab you can install the [Data Inheritance Plugin](https://github.com/pattern-lab/plugin-php-data-inheritance).
+
+## Re-ordering Pseudo-Patterns
+
+To learn how to re-order pseudo-patterns, check [Reorganizing Patterns](pattern-reorganizing.md).
\ No newline at end of file
diff --git a/docs/pattern-reorganizing.md b/docs/pattern-reorganizing.md
index 3dd191c..cfceebf 100644
--- a/docs/pattern-reorganizing.md
+++ b/docs/pattern-reorganizing.md
@@ -31,3 +31,15 @@ You may want to put some space between the numbers just in case you want to furt
 ```
 
 The numbers will not show up when Pattern Lab displays the name of the pattern in the drop-down navigation. They're simply a re-ordering mechanism.
+
+##Re-ordering Pseudo-Patterns
+
+When re-ordering pseudo-patterns the rules are slightly different. The numbers go **after** the tilde sign (`~`) rather than at the beggining of the file name:
+
+```
+- pattern.mustache
+- pattern.yml
+- pattern~01-variation2.yml
+- pattern~02-variation3.yml
+- pattern~03-variation1.yml
+```
\ No newline at end of file