diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
index 00ea5d4..e33425b 100644
--- a/src/site/xdoc/index.xml
+++ b/src/site/xdoc/index.xml
@@ -42,17 +42,12 @@
 
                 <p>
                     <center>
-                        <object width="800" height="600">
-                            <param name="movie"
-                                   value="http://www.youtube.com/v/g2YvzOloNyI&#38;hl=de_DE&#38;fs=1&#38;border=1"></param>
-                            <param name="allowFullScreen" value="true"></param>
-                            <param name="allowscriptaccess" value="always"></param>
-                            <embed src="http://www.youtube.com/v/g2YvzOloNyI&#38;hl=de_DE&#38;fs=1&#38;border=1"
-                                   type="application/x-shockwave-flash" allowscriptaccess="always"
-                                   allowfullscreen="true" width="800" height="550"></embed>
-                        </object>
+                        <iframe class="youtube-player" type="text/html" width="800" height="600"
+                                src="http://www.youtube.com/embed/g2YvzOloNyI" frameborder="0">
+                        </iframe>
                     </center>
 
+
                 </p>
                 <p>
                     As the video shows, you can make changes to almost all JSF artifacts on the fly, and at the next
diff --git a/src/site/xdoc/installation.xml b/src/site/xdoc/installation.xml
index a54c7cd..0d4567e 100644
--- a/src/site/xdoc/installation.xml
+++ b/src/site/xdoc/installation.xml
@@ -201,15 +201,15 @@
 
                 <p>First a context param has to be set which attaches the Ext-Scripting plugins to MyFaces</p>
                 <source><![CDATA[
-     <context-param>
-        <description>
-            Enables our scripting engine support plugins
-        </description>
-        <param-name>org.apache.myfaces.FACES_INIT_PLUGINS</param-name>
-        <param-value>
-            org.apache.myfaces.extensions.scripting.servlet.StartupServletContextPluginChainLoader
-        </param-value>
-     </context-param>]]></source>
+ <context-param>
+    <description>
+        Enables our scripting engine support plugins
+    </description>
+    <param-name>org.apache.myfaces.FACES_INIT_PLUGINS</param-name>
+    <param-value>
+        org.apache.myfaces.extensions.scripting.servlet.StartupServletContextPluginChainLoader
+    </param-value>
+ </context-param>]]></source>
 
                 <h4>Additional Optional Steps</h4>
                 <p>Ext-Scripting exposes a number configuration parameters which can be set via context parameters in
@@ -248,24 +248,24 @@
                     allow the rerouting of source locations of the supported languages!
                 </p>
                 <source><![CDATA[
-    <context-param>
-        <description>Additional comma separated loader paths to allow direct editing on the sources directory instead
-            of the deployment dir
-        </description>
-        <param-name>org.apache.myfaces.extensions.scripting.groovy.LOADER_PATHS</param-name>
-        <param-value>
-           <some project path>/src/main/webapp/WEB-INF/groovy
-        </param-value>
-    </context-param>
-    <context-param>
-        <description>Additional comma separated loader paths to allow direct editing on the sources directory instead
-            of the deployment dir
-        </description>
-        <param-name>org.apache.myfaces.extensions.scripting.java.LOADER_PATHS</param-name>
-        <param-value>
-            <some project path>/src/main/webapp/WEB-INF/java
-        </param-value>
-    </context-param>
+<context-param>
+    <description>Additional comma separated loader paths to allow direct editing on the sources directory instead
+        of the deployment dir
+    </description>
+    <param-name>org.apache.myfaces.extensions.scripting.groovy.LOADER_PATHS</param-name>
+    <param-value>
+       <some project path>/src/main/webapp/WEB-INF/groovy
+    </param-value>
+</context-param>
+<context-param>
+    <description>Additional comma separated loader paths to allow direct editing on the sources directory instead
+        of the deployment dir
+    </description>
+    <param-name>org.apache.myfaces.extensions.scripting.java.LOADER_PATHS</param-name>
+    <param-value>
+        <some project path>/src/main/webapp/WEB-INF/java
+    </param-value>
+</context-param>
                 ]]></source>
                 <ul>
                     <li>
@@ -295,34 +295,57 @@
                 </ul>
 
                 <source><![CDATA[
-         <!-- ======================================================================================
-                     Optional Loader Paths for resource files
-              ====================================================================================== -->
-             <context-param>
-                 <description>resource paths for our custom JSF2 resource resolver</description>
-                 <param-name>org.apache.myfaces.extensions.scripting.resources.LOADER_PATHS</param-name>
-                 <param-value>
-                     /Users/werpu2/development/workspace/extensions-scripting3/examples/myfaces20-example/src/main/webapp
-                 </param-value>
-             </context-param>
+<!-- ======================================================================================
+         Optional Loader Paths for resource files
+  ====================================================================================== -->
+ <context-param>
+     <description>resource paths for our custom JSF2 resource resolver</description>
+     <param-name>org.apache.myfaces.extensions.scripting.resources.LOADER_PATHS</param-name>
+     <param-value>
+         ~/extensions-scripting3/examples/myfaces20-example/src/main/webapp
+     </param-value>
+ </context-param>
 
-         <!-- ======================================================================================
-              Optional: Tell Facelets to load the resources from your source dir
-              ====================================================================================== -->
-             <context-param>
-                 <description>a redirecting Facelet resource resolver which allows to pick up templates and resources from our
-                     source dir
-                 </description>
-                 <param-name>facelets.RESOURCE_RESOLVER</param-name>
-                 <param-value>org.apache.myfaces.extensions.scripting.facelet.ReroutingResourceResolver</param-value>
-             </context-param>
+<!-- ======================================================================================
+  Optional: Tell Facelets to load the resources from your source dir
+  ====================================================================================== -->
+ <context-param>
+     <description>a redirecting Facelet resource resolver which allows to pick up templates
+        and resources from our source dir
+     </description>
+     <param-name>facelets.RESOURCE_RESOLVER</param-name>
+     <param-value>org.apache.myfaces.extensions.scripting.facelet.ReroutingResourceResolver</param-value>
+ </context-param>
         ]]></source>
                 </p>
                 This sums up the quick install and setup guide, if you want more detailed setup examples and
                 additional configuration entries
                 go to our <a href="exampleconfig.html">Example Configurations</a> page, which shows
                 a set of different configurations.
+
+
+            <h4>Package Whitelisting</h4>
+            <p>The last possible config entry is the ability to whitelist packages. If you have set this option
+            then only whitelisted packages will be picked up for dynamic recompilation</p>
+            <p>With this option you can point your sourcedir to the normal compile source and mark
+            special packages as dynamic (to isolate the dynamic part from the rest)</p>
+
+            For enabling this option add following entry to your web.xml:
+             <source><![CDATA[
+<!-- ======================================================================================
+    Optional: Whitelist of root packages where your sources should come from
+ ====================================================================================== -->
+<context-param>
+    <description>a comma separated whitelist of root packages which are compiled those and nothing else
+        will be compiled during all compile stages, all other files stay permanently as they are
+    </description>
+    <param-name>org.apache.myfaces.extensions.scripting.PGK_WHITELIST</param-name>
+    <param-value>org.apache.myfaces.groovyloader.blog,org.apache.myfaces.javaloader.blog</param-value>
+</context-param>
+             ]]></source>
             </subsection>
+
+
         </section>
 
         <section name="Navigation Bottom">
diff --git a/src/site/xdoc/using_advanced.xml b/src/site/xdoc/using_advanced.xml
index 1b1de87..b2e634c 100644
--- a/src/site/xdoc/using_advanced.xml
+++ b/src/site/xdoc/using_advanced.xml
@@ -100,16 +100,9 @@
                 <p>The following Video shows the compiler output component in action</p>
                 <p>
                     <center>
-                        <object width="640px" height="505px">
-                            <param name="movie"
-                                   value="http://www.youtube.com/v/v56ru9ZJyhQ&#38;hl=de_DE&#38;fs=1&#38;hd=1&#38;border=1" />
-                            <param name="allowFullScreen" value="true" />
-                            <param name="allowscriptaccess" value="always" />
-                            <embed src="http://www.youtube.com/v/v56ru9ZJyhQ&#38;hl=de_DE&#38;fs=1&#38;hd=1&#38;border=1"
-                                   type="application/x-shockwave-flash" allowscriptaccess="always"
-                                   allowfullscreen="true"
-                                   width="640px" height="505px" />
-                        </object>
+                        <iframe class="youtube-player" type="text/html" width="640" height="505"
+                                                        src="http://www.youtube.com/embed/v56ru9ZJyhQ" frameborder="0">
+                        </iframe>
                     </center>
                     <div class="objectAnnotation">Video: Compiler Component in Action</div>
 
@@ -310,18 +303,11 @@
             </p>
             <p />
             <center>
-
-                <object width="660" height="405">
-                    <param name="movie"
-                           value="http://www.youtube.com/v/YWlBGE3vyMw&#38;hl=de_DE&#38;fs=1?&#38;border=1" />
-                    <param name="allowFullScreen" value="true" />
-                    <param name="allowscriptaccess" value="always" />
-                    <embed src="http://www.youtube.com/v/YWlBGE3vyMw&#38;hl=de_DE&#38;fs=1&#38;?&#38;border=1"
-                           type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true"
-                           width="660" height="405" />
-                </object>
-
-
+                <center>
+                    <iframe class="youtube-player" type="text/html" width="660" height="405"
+                                                    src="http://www.youtube.com/embed/YWlBGE3vyMw" frameborder="0">
+                    </iframe>
+                </center>
             </center>
             <p>
                 This dependency detection works over all dynamic classes, no matter being it classes, interfaces,
@@ -349,15 +335,11 @@
             </p>
 
             <center>
-                <object width="640" height="505">
-                    <param name="movie"
-                           value="http://www.youtube.com/v/tikOR0XDnFw&#38;hl=de_DE&#38;fs=1&#38;hd=1&#38;border=1" />
-                    <param name="allowFullScreen" value="true" />
-                    <param name="allowscriptaccess" value="always" />
-                    <embed src="http://www.youtube.com/v/tikOR0XDnFw&#38;hl=de_DE&#38;fs=1&#38;hd=1&#38;border=1"
-                           type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true"
-                           width="640" height="505" />
-                </object>
+                <center>
+                    <iframe class="youtube-player" type="text/html" width="640" height="505"
+                                                    src="http://www.youtube.com/embed/tikOR0XDnFw" frameborder="0">
+                    </iframe>
+                </center>
             </center>
         </section>
 
diff --git a/src/site/xdoc/using_general.xml b/src/site/xdoc/using_general.xml
index 67f85a1..4ec5395 100644
--- a/src/site/xdoc/using_general.xml
+++ b/src/site/xdoc/using_general.xml
@@ -49,15 +49,10 @@
                 and in the following videos in the Users Guide.
             </p>
             <center>
-                <object width="640px" height="480px">
-                    <param name="movie"
-                           value="http://www.youtube.com/v/vUCCTCMjTPE&#38;hl=de_DE&#38;fs=1&#38;"></param>
-                    <param name="allowFullScreen" value="true"></param>
-                    <param name="allowscriptaccess" value="always"></param>
-                    <embed src="http://www.youtube.com/v/vUCCTCMjTPE&#38;hl=de_DE&#38;fs=1&#38;"
-                           type="application/x-shockwave-flash" allowscriptaccess="always"
-                           allowfullscreen="true" width="640px" height="480px"></embed>
-                </object>
+                <iframe class="youtube-player" type="text/html" width="640" height="480"
+                                                                    src="http://www.youtube.com/embed/vUCCTCMjTPE" frameborder="0">
+                                    </iframe>
+
             </center>
             <div class="objectAnnotation">Video: Development Lifecycle in Action</div>