diff --git a/MANIFEST.in b/MANIFEST.in
index 42c013e59..bd9913f36 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -5,7 +5,6 @@ include distribute_setup.py
 include LICENSE 
 graft doc
 graft contrib
-graft example
 graft bin 
 exclude *.orig 
 exclude *.rej 
diff --git a/example/assertion/failure_demo.py b/doc/example/assertion/failure_demo.py
similarity index 100%
rename from example/assertion/failure_demo.py
rename to doc/example/assertion/failure_demo.py
diff --git a/example/assertion/global_testmodule_config/conftest.py b/doc/example/assertion/global_testmodule_config/conftest.py
similarity index 100%
rename from example/assertion/global_testmodule_config/conftest.py
rename to doc/example/assertion/global_testmodule_config/conftest.py
diff --git a/example/assertion/global_testmodule_config/test_hello.py b/doc/example/assertion/global_testmodule_config/test_hello.py
similarity index 100%
rename from example/assertion/global_testmodule_config/test_hello.py
rename to doc/example/assertion/global_testmodule_config/test_hello.py
diff --git a/example/assertion/test_failures.py b/doc/example/assertion/test_failures.py
similarity index 100%
rename from example/assertion/test_failures.py
rename to doc/example/assertion/test_failures.py
diff --git a/example/assertion/test_setup_flow_example.py b/doc/example/assertion/test_setup_flow_example.py
similarity index 100%
rename from example/assertion/test_setup_flow_example.py
rename to doc/example/assertion/test_setup_flow_example.py
diff --git a/example/funcarg/conftest.py b/doc/example/funcarg/conftest.py
similarity index 100%
rename from example/funcarg/conftest.py
rename to doc/example/funcarg/conftest.py
diff --git a/example/funcarg/costlysetup/conftest.py b/doc/example/funcarg/costlysetup/conftest.py
similarity index 100%
rename from example/funcarg/costlysetup/conftest.py
rename to doc/example/funcarg/costlysetup/conftest.py
diff --git a/example/funcarg/costlysetup/sub1/__init__.py b/doc/example/funcarg/costlysetup/sub1/__init__.py
similarity index 100%
rename from example/funcarg/costlysetup/sub1/__init__.py
rename to doc/example/funcarg/costlysetup/sub1/__init__.py
diff --git a/example/funcarg/costlysetup/sub1/test_quick.py b/doc/example/funcarg/costlysetup/sub1/test_quick.py
similarity index 100%
rename from example/funcarg/costlysetup/sub1/test_quick.py
rename to doc/example/funcarg/costlysetup/sub1/test_quick.py
diff --git a/example/funcarg/costlysetup/sub2/__init__.py b/doc/example/funcarg/costlysetup/sub2/__init__.py
similarity index 100%
rename from example/funcarg/costlysetup/sub2/__init__.py
rename to doc/example/funcarg/costlysetup/sub2/__init__.py
diff --git a/example/funcarg/costlysetup/sub2/test_two.py b/doc/example/funcarg/costlysetup/sub2/test_two.py
similarity index 100%
rename from example/funcarg/costlysetup/sub2/test_two.py
rename to doc/example/funcarg/costlysetup/sub2/test_two.py
diff --git a/example/funcarg/mysetup/__init__.py b/doc/example/funcarg/mysetup/__init__.py
similarity index 100%
rename from example/funcarg/mysetup/__init__.py
rename to doc/example/funcarg/mysetup/__init__.py
diff --git a/example/funcarg/mysetup/conftest.py b/doc/example/funcarg/mysetup/conftest.py
similarity index 100%
rename from example/funcarg/mysetup/conftest.py
rename to doc/example/funcarg/mysetup/conftest.py
diff --git a/example/funcarg/mysetup/myapp.py b/doc/example/funcarg/mysetup/myapp.py
similarity index 100%
rename from example/funcarg/mysetup/myapp.py
rename to doc/example/funcarg/mysetup/myapp.py
diff --git a/example/funcarg/mysetup/test_sample.py b/doc/example/funcarg/mysetup/test_sample.py
similarity index 100%
rename from example/funcarg/mysetup/test_sample.py
rename to doc/example/funcarg/mysetup/test_sample.py
diff --git a/example/funcarg/mysetup2/__init__.py b/doc/example/funcarg/mysetup2/__init__.py
similarity index 100%
rename from example/funcarg/mysetup2/__init__.py
rename to doc/example/funcarg/mysetup2/__init__.py
diff --git a/example/funcarg/mysetup2/conftest.py b/doc/example/funcarg/mysetup2/conftest.py
similarity index 100%
rename from example/funcarg/mysetup2/conftest.py
rename to doc/example/funcarg/mysetup2/conftest.py
diff --git a/example/funcarg/mysetup2/myapp.py b/doc/example/funcarg/mysetup2/myapp.py
similarity index 100%
rename from example/funcarg/mysetup2/myapp.py
rename to doc/example/funcarg/mysetup2/myapp.py
diff --git a/example/funcarg/mysetup2/test_sample.py b/doc/example/funcarg/mysetup2/test_sample.py
similarity index 100%
rename from example/funcarg/mysetup2/test_sample.py
rename to doc/example/funcarg/mysetup2/test_sample.py
diff --git a/example/funcarg/mysetup2/test_ssh.py b/doc/example/funcarg/mysetup2/test_ssh.py
similarity index 100%
rename from example/funcarg/mysetup2/test_ssh.py
rename to doc/example/funcarg/mysetup2/test_ssh.py
diff --git a/example/funcarg/parametrize/test_parametrize.py b/doc/example/funcarg/parametrize/test_parametrize.py
similarity index 100%
rename from example/funcarg/parametrize/test_parametrize.py
rename to doc/example/funcarg/parametrize/test_parametrize.py
diff --git a/example/funcarg/parametrize/test_parametrize2.py b/doc/example/funcarg/parametrize/test_parametrize2.py
similarity index 100%
rename from example/funcarg/parametrize/test_parametrize2.py
rename to doc/example/funcarg/parametrize/test_parametrize2.py
diff --git a/example/funcarg/parametrize/test_parametrize3.py b/doc/example/funcarg/parametrize/test_parametrize3.py
similarity index 100%
rename from example/funcarg/parametrize/test_parametrize3.py
rename to doc/example/funcarg/parametrize/test_parametrize3.py
diff --git a/example/funcarg/test_multi_python.py b/doc/example/funcarg/test_multi_python.py
similarity index 100%
rename from example/funcarg/test_multi_python.py
rename to doc/example/funcarg/test_multi_python.py
diff --git a/example/funcarg/test_simpleprovider.py b/doc/example/funcarg/test_simpleprovider.py
similarity index 100%
rename from example/funcarg/test_simpleprovider.py
rename to doc/example/funcarg/test_simpleprovider.py
diff --git a/example/funcarg/urloption/conftest.py b/doc/example/funcarg/urloption/conftest.py
similarity index 100%
rename from example/funcarg/urloption/conftest.py
rename to doc/example/funcarg/urloption/conftest.py
diff --git a/example/genhtml.py b/doc/example/genhtml.py
similarity index 100%
rename from example/genhtml.py
rename to doc/example/genhtml.py
diff --git a/example/genhtmlcss.py b/doc/example/genhtmlcss.py
similarity index 100%
rename from example/genhtmlcss.py
rename to doc/example/genhtmlcss.py
diff --git a/example/genxml.py b/doc/example/genxml.py
similarity index 100%
rename from example/genxml.py
rename to doc/example/genxml.py