Add customization documentation page

docs/contents.rst

@@ -15,8 +15,6 @@ Mayan EDMS documentation contents
     intro/index
     topics/index
     releases/index
-    topics/settings
-    topics/development
     credits/index
     faq/index
     

docs/index.rst

@@ -61,7 +61,7 @@ Between versions
 Customization and fine tunning
 ==============================
 
-  :doc:`Settings <topics/settings>`
+  :doc:`Settings <topics/settings>` | :doc:`Customization <topics/customization>`
   
 
 For developers

docs/topics/customization.rst

@@ -0,0 +1,35 @@
+=============
+Customization
+=============
+
+The general appearance of **Mayan EDMS** can be customized entirely just
+by changing a few settings.
+
+**Mayan EDMS** uses `Andrea Franz's excellent web app template`_ which includes
+several themes that could be used to adapt **Mayan EDMS**'s appearance to match
+an organtization existing applications' look and feel.
+
+The theme can be changed very easily by settings the :setting:`WEB_THEME_THEME`
+configuration option to one of its valid values.
+
+.. image:: themes.png
+ :alt: themes
+
+The amount of information presented at the login screen can also be restricted
+if for security or desgin reasons using :setting:`WEB_THEME_VERBOSE_LOGIN`
+configuration option.
+
+.. image:: mayan-login.png
+ :alt: mayan login screen
+
+Sometimes users just want to go directly to work and not just be greeted with
+a home screen, for these kind of situations **Mayan EDMS** has the
+:setting:`MAIN_DISABLE_HOME_VIEW` configuration option which will cause
+users to land on their ``recent document list`` as soon as they log in.
+
+Some themes such as ``default`` might be more visually appealing to some
+people without the menu icons, for this **Mayan EDMS** provides the
+:setting:`MAIN_DISABLE_ICONS` configuration option.
+
+.. image:: no-icons.png
+ :alt: mayan screens with out icons

docs/topics/index.rst

@@ -16,3 +16,6 @@ Introductions to all the key parts of Mayan EDMS you'll need to know:
    indexes
    smart_links
    ocr
+   settings
+   customization
+   development