diff --git a/docs/designers/language-builtin-functions/language-function-foreach.md b/docs/designers/language-builtin-functions/language-function-foreach.md
index 645d6c52..a0b7b588 100644
--- a/docs/designers/language-builtin-functions/language-function-foreach.md
+++ b/docs/designers/language-builtin-functions/language-function-foreach.md
@@ -166,7 +166,7 @@ looping over a PHP iterator instead of an array().
 
 ```php
 <?php 
-  include('Smarty.class.php'); 
+  use Smarty\Smarty;
 
   $smarty = new Smarty; 
 
diff --git a/docs/designers/language-variables/language-assigned-variables.md b/docs/designers/language-variables/language-assigned-variables.md
index bd356a2b..a358008f 100644
--- a/docs/designers/language-variables/language-assigned-variables.md
+++ b/docs/designers/language-variables/language-assigned-variables.md
@@ -7,7 +7,7 @@ Variables assigned from PHP are referenced by preceding them with a dollar
 
 ```php
 <?php
-
+use Smarty\Smarty;
 $smarty = new Smarty();
 
 $smarty->assign('firstname', 'Doug');
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 35b4e135..a827b4a3 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -26,6 +26,7 @@ Here's how you create an instance of Smarty in your PHP scripts:
 <?php
 
 require 'vendor/autoload.php';
+use Smarty\Smarty;
 $smarty = new Smarty();
 ```
 
@@ -44,7 +45,7 @@ The defaults can be changed as follows:
 
 ```php
 <?php
-
+use Smarty\Smarty;
 $smarty = new Smarty();
 $smarty->setTemplateDir('/some/template/dir');
 $smarty->setConfigDir('/some/config/dir');
@@ -73,6 +74,8 @@ You can verify if your system has the correct access rights for
     these directories with [`testInstall()`](./programmers/api-functions/api-test-install.md):
 
 ```php
+<?php
+use Smarty\Smarty;
 $smarty = new Smarty();
 $smarty->setTemplateDir('/some/template/dir');
 $smarty->setConfigDir('/some/config/dir');
@@ -106,6 +109,7 @@ Now lets edit our php file. We'll create an instance of Smarty,
 
 require 'vendor/autoload.php';
 
+use Smarty\Smarty;
 $smarty = new Smarty();
 
 $smarty->setTemplateDir('/web/www.example.com/guestbook/templates/');
diff --git a/docs/programmers/advanced-features/advanced-features-security.md b/docs/programmers/advanced-features/advanced-features-security.md
index 160754ad..4379eaad 100644
--- a/docs/programmers/advanced-features/advanced-features-security.md
+++ b/docs/programmers/advanced-features/advanced-features-security.md
@@ -85,6 +85,8 @@ Smarty\_Security class or create an instance of it.
 
     <?php
 
+    use Smarty\Smarty;
+
     class My_Security_Policy extends \Smarty\Security {
       public $allow_constants = false;
     }
@@ -95,6 +97,7 @@ Smarty\_Security class or create an instance of it.
 
 
     <?php
+    use Smarty\Smarty;
     $smarty = new Smarty();
     $my_security_policy = new \Smarty\Security($smarty);
     $my_security_policy->allow_constants = false;
@@ -104,7 +107,7 @@ Smarty\_Security class or create an instance of it.
 
 
     <?php
-    require 'Smarty.class.php';
+    use Smarty\Smarty;
     $smarty = new Smarty();
     // enable default security
     $smarty->enableSecurity();
diff --git a/docs/programmers/api-functions/api-compile-all-config.md b/docs/programmers/api-functions/api-compile-all-config.md
index a102fc97..35497d9a 100644
--- a/docs/programmers/api-functions/api-compile-all-config.md
+++ b/docs/programmers/api-functions/api-compile-all-config.md
@@ -50,7 +50,7 @@ parameters:
 
 
     <?php
-    include('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     // force compilation of all config files
diff --git a/docs/programmers/api-functions/api-compile-all-templates.md b/docs/programmers/api-functions/api-compile-all-templates.md
index 53a021da..2be22eef 100644
--- a/docs/programmers/api-functions/api-compile-all-templates.md
+++ b/docs/programmers/api-functions/api-compile-all-templates.md
@@ -60,7 +60,7 @@ parameters:
 
 
     <?php
-    include('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     // force compilation of all template files
diff --git a/docs/programmers/api-functions/api-create-data.md b/docs/programmers/api-functions/api-create-data.md
index 7e083776..dc03ad94 100644
--- a/docs/programmers/api-functions/api-create-data.md
+++ b/docs/programmers/api-functions/api-create-data.md
@@ -30,7 +30,7 @@ be used to control which variables are seen by which templates.
 
 
     <?php
-    include('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     // create data object with its private variable scope
diff --git a/docs/programmers/api-functions/api-create-template.md b/docs/programmers/api-functions/api-create-template.md
index 5129406d..097b7df9 100644
--- a/docs/programmers/api-functions/api-create-template.md
+++ b/docs/programmers/api-functions/api-create-template.md
@@ -80,7 +80,7 @@ following parameters:
 
 
     <?php
-    include('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     // create template object with its private variable scope
diff --git a/docs/programmers/api-functions/api-fetch.md b/docs/programmers/api-functions/api-fetch.md
index 6da05bd0..491c28d4 100644
--- a/docs/programmers/api-functions/api-fetch.md
+++ b/docs/programmers/api-functions/api-fetch.md
@@ -30,7 +30,7 @@ PARAMETER.COMPILEID
 
 
     <?php
-    include('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(true);
diff --git a/docs/programmers/api-functions/api-register-class.md b/docs/programmers/api-functions/api-register-class.md
index ee339cad..d0156d51 100644
--- a/docs/programmers/api-functions/api-register-class.md
+++ b/docs/programmers/api-functions/api-register-class.md
@@ -24,6 +24,7 @@ otherwise. If security is enabled, classes registered with
 
 
     <?php
+    use Smarty\Smarty;
 
     class Bar {
       $property = "hello world";
@@ -44,12 +45,14 @@ otherwise. If security is enabled, classes registered with
 
 
     <?php
+    use Smarty\Smarty;
+
     namespace my\php\application {
       class Bar {
         $property = "hello world";
       }
     }
-
+   
     $smarty = new Smarty();
     $smarty->registerClass("Foo", "\my\php\application\Bar");
 
diff --git a/docs/programmers/api-functions/api-register-default-plugin-handler.md b/docs/programmers/api-functions/api-register-default-plugin-handler.md
index b75a9f30..61ac4761 100644
--- a/docs/programmers/api-functions/api-register-default-plugin-handler.md
+++ b/docs/programmers/api-functions/api-register-default-plugin-handler.md
@@ -25,7 +25,7 @@ plugin types.
 
 
     <?php
-
+    use Smarty\Smarty;
     $smarty = new Smarty();
     $smarty->registerDefaultPluginHandler('my_plugin_handler');
 
diff --git a/docs/programmers/api-functions/api-test-install.md b/docs/programmers/api-functions/api-test-install.md
index 918bd220..bba64a19 100644
--- a/docs/programmers/api-functions/api-test-install.md
+++ b/docs/programmers/api-functions/api-test-install.md
@@ -14,7 +14,7 @@ installation can be accessed. It does output a corresponding protocol.
 
 
     <?php
-    require_once('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty  = new Smarty();
     $smarty->testInstall();
     ?>
diff --git a/docs/programmers/api-variables/variable-default-config-handler-func.md b/docs/programmers/api-variables/variable-default-config-handler-func.md
index 90891426..50eb65bb 100644
--- a/docs/programmers/api-variables/variable-default-config-handler-func.md
+++ b/docs/programmers/api-variables/variable-default-config-handler-func.md
@@ -12,7 +12,7 @@ resource.
 
 
     <?php
-
+    use Smarty\Smarty;
     $smarty = new Smarty();
     $smarty->default_config_handler_func = 'my_default_config_handler_func';
 
diff --git a/docs/programmers/api-variables/variable-default-template-handler-func.md b/docs/programmers/api-variables/variable-default-template-handler-func.md
index 8e9efa9d..96c8190d 100644
--- a/docs/programmers/api-variables/variable-default-template-handler-func.md
+++ b/docs/programmers/api-variables/variable-default-template-handler-func.md
@@ -12,7 +12,7 @@ resource.
 
 
     <?php
-
+    use Smarty\Smarty;
     $smarty = new Smarty();
     $smarty->default_template_handler_func = 'my_default_template_handler_func';
 
diff --git a/docs/programmers/caching/caching-custom.md b/docs/programmers/caching/caching-custom.md
index e9c33368..b53afcfd 100644
--- a/docs/programmers/caching/caching-custom.md
+++ b/docs/programmers/caching/caching-custom.md
@@ -38,7 +38,7 @@ to invoke your custom CacheResource implementation.
 
     <?php
 
-    require_once 'libs/Smarty.class.php';
+    use Smarty\Smarty;
     $smarty = new Smarty();
     $smarty->caching_type = 'mysql';
 
@@ -198,7 +198,7 @@ to invoke your custom CacheResource implementation.
 
     <?php
 
-    require_once 'libs/Smarty.class.php';
+    use Smarty\Smarty;
     $smarty = new Smarty();
     $smarty->caching_type = 'memcache';
 
diff --git a/docs/programmers/caching/caching-groups.md b/docs/programmers/caching/caching-groups.md
index 7e248b2f..a3502f3f 100644
--- a/docs/programmers/caching/caching-groups.md
+++ b/docs/programmers/caching/caching-groups.md
@@ -38,7 +38,7 @@ structure that mimics your template file structure, such as
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
diff --git a/docs/programmers/caching/caching-multiple-caches.md b/docs/programmers/caching/caching-multiple-caches.md
index 40fffc3d..a25e442c 100644
--- a/docs/programmers/caching/caching-multiple-caches.md
+++ b/docs/programmers/caching/caching-multiple-caches.md
@@ -10,7 +10,7 @@ parameter to the function call.
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
@@ -47,7 +47,7 @@ Be sure to pass the same `$cache_id` as the second parameter to
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
@@ -70,7 +70,7 @@ the first parameter to [`clearCache()`](#api.clear.cache).
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
diff --git a/docs/programmers/caching/caching-setting-up.md b/docs/programmers/caching/caching-setting-up.md
index 3a79d6f8..189c7cd3 100644
--- a/docs/programmers/caching/caching-setting-up.md
+++ b/docs/programmers/caching/caching-setting-up.md
@@ -7,7 +7,7 @@ The first thing to do is enable caching by setting
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     // uses the value of $smarty->cacheLifetime() to determine
@@ -41,7 +41,7 @@ setting [`$caching`](#variable.caching) to
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     // retain current cache lifetime for each specific display call
@@ -75,7 +75,7 @@ This is a computational overhead, so for optimum performance set
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
@@ -101,7 +101,7 @@ process.
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
@@ -133,7 +133,7 @@ files [and groups](#caching.groups) with the
 
 
     <?php
-    require('Smarty.class.php');
+    use Smarty\Smarty;
     $smarty = new Smarty;
 
     $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
diff --git a/docs/programmers/plugins/plugins-resources.md b/docs/programmers/plugins/plugins-resources.md
index 400f4efa..86a18127 100644
--- a/docs/programmers/plugins/plugins-resources.md
+++ b/docs/programmers/plugins/plugins-resources.md
@@ -31,6 +31,8 @@ example.
 
     <?php
 
+    use Smarty\Smarty;
+
     /**
      * MySQL Resource
      *
@@ -107,7 +109,7 @@ example.
     }
 
 
-    require_once 'libs/Smarty.class.php';
+    
     $smarty = new Smarty();
     $smarty->registerResource('mysql', new My_Resource_Mysql());
 
diff --git a/docs/programmers/resources/resources-custom.md b/docs/programmers/resources/resources-custom.md
index 7d05e4f5..1c41de1c 100644
--- a/docs/programmers/resources/resources-custom.md
+++ b/docs/programmers/resources/resources-custom.md
@@ -17,6 +17,8 @@ on the functions you are supposed to provide.
 
     <?php
 
+    use Smarty\Smarty;
+
     /**
     * MySQL Resource
     *
@@ -93,7 +95,7 @@ on the functions you are supposed to provide.
     }
 
 
-    require_once 'libs/Smarty.class.php';
+    
     $smarty = new Smarty();
     $smarty->registerResource('mysql', new My_Resource_Mysql());
 
diff --git a/docs/programmers/resources/template-resources.md b/docs/programmers/resources/template-resources.md
index a14e518f..15662493 100644
--- a/docs/programmers/resources/template-resources.md
+++ b/docs/programmers/resources/template-resources.md
@@ -26,6 +26,8 @@ on the functions you are supposed to provide.
 
 
     <?php
+    use Smarty\Smarty;
+
 
     /**
      * MySQL Resource
@@ -103,7 +105,7 @@ on the functions you are supposed to provide.
     }
 
 
-    require_once 'libs/Smarty.class.php';
+   
     $smarty = new Smarty();
     $smarty->registerResource('mysql', new My_Resource_Mysql());