Merge pull request #3945 from jedateach/pr/3/modulethemedocs

DOCS Explain the module specific themes separation capability of Silverstripe

docs/en/02_Developer_Guides/01_Templates/05_Template_Inheritance.md

@@ -46,9 +46,10 @@ your entire project for the appropriate `.ss` files located in `template` direct
 It will each and prioritize templates in the following priority:
 
 1. mysite (or other name given to site folder)
-2. themes
-3. modules 
-4. framework.
+2. module-specific themes (e.g. themes/simple_blog)
+3. themes (e.g. themes/simple)
+4. modules  (e.g. blog)
+5. framework
 
 <div class="warning">
 Whenever you add or remove template files, rebuild the manifest by visiting `http://yoursite.com/?flush=1`. You can 

docs/en/02_Developer_Guides/01_Templates/06_Themes.md

@@ -47,6 +47,30 @@ located within the `themes` directory.
 
 ![themes:basicfiles.gif](../../_images/basicfiles.gif)
 
+Your theme can also be organised into split folders for each module it caters for.
+
+```
+themes
+    blackcandy
+        css
+            style.css
+        images
+        templates
+            Page.ss
+            Layout
+                Page.ss
+            Includes
+    blackcandy_blog
+        css
+            blog.css
+        images
+        templates
+            Layout
+                BlogHolder.ss
+                BlogEntry.ss
+            Includes
+```
+
 ## Submitting your theme to SilverStripe
 
 If you want to submit your theme to the SilverStripe directory then check