diff --git a/ktwsapi/examples/ktws_eg_add_document.php b/ktwsapi/examples/ktws_eg_add_document.php
new file mode 100644
index 0000000..78c623f
--- /dev/null
+++ b/ktwsapi/examples/ktws_eg_add_document.php
@@ -0,0 +1,45 @@
+<?
+
+/**
+ *
+ * This is a sample of how to add a document to the repository.
+ *
+ * The contents of this file are subject to the KnowledgeTree Public
+ * License Version 1.1 ("License"); You may not use this file except in
+ * compliance with the License. You may obtain a copy of the License at
+ * http://www.knowledgetree.com/KPL
+ * 
+ * Software distributed under the License is distributed on an "AS IS"
+ * basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ * 
+ * The Original Code is: KnowledgeTree Open Source
+ * 
+ * The Initial Developer of the Original Code is The Jam Warehouse Software
+ * (Pty) Ltd, trading as KnowledgeTree.
+ * Portions created by The Jam Warehouse Software (Pty) Ltd are Copyright
+ * (C) 2007 The Jam Warehouse Software (Pty) Ltd;
+ * All Rights Reserved.
+ *
+ */
+
+require_once('../ktwsapi.inc.php');
+
+$ktapi = new KTWSAPI(KTWebService_WSDL);
+
+$response = $ktapi->start_session('admin','admin');
+if (PEAR::isError($response))
+{
+	print $response->getMessage();
+	exit;
+}
+
+$root = $ktapi->get_root_folder();
+
+$root->add_document('c:/temp/test.doc');
+
+$ktapi->logout();
+ 
+?>
\ No newline at end of file
diff --git a/ktwsapi/examples/ktws_eg_anonymous.php b/ktwsapi/examples/ktws_eg_anonymous.php
new file mode 100644
index 0000000..6c97a08
--- /dev/null
+++ b/ktwsapi/examples/ktws_eg_anonymous.php
@@ -0,0 +1,48 @@
+<?
+
+/**
+ *
+ * Demonstrates how to create an anonymous session.
+ *
+ * The contents of this file are subject to the KnowledgeTree Public
+ * License Version 1.1 ("License"); You may not use this file except in
+ * compliance with the License. You may obtain a copy of the License at
+ * http://www.knowledgetree.com/KPL
+ * 
+ * Software distributed under the License is distributed on an "AS IS"
+ * basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ * 
+ * The Original Code is: KnowledgeTree Open Source
+ * 
+ * The Initial Developer of the Original Code is The Jam Warehouse Software
+ * (Pty) Ltd, trading as KnowledgeTree.
+ * Portions created by The Jam Warehouse Software (Pty) Ltd are Copyright
+ * (C) 2007 The Jam Warehouse Software (Pty) Ltd;
+ * All Rights Reserved.
+ *
+ */
+
+require_once('../ktwsapi.inc.php');
+
+$ktapi = new KTWSAPI(KTWebService_WSDL);
+
+$response = $ktapi->start_anonymous_session();
+if (PEAR::isError($response))
+{
+	print $response->getMessage();
+	exit;
+}
+
+// do something
+
+$root=$ktapi->get_root_folder();
+
+// when done, logout
+
+
+$ktapi->logout();
+ 
+?>
\ No newline at end of file
diff --git a/ktwsapi/examples/ktws_eg_checkin.php b/ktwsapi/examples/ktws_eg_checkin.php
new file mode 100644
index 0000000..0168d03
--- /dev/null
+++ b/ktwsapi/examples/ktws_eg_checkin.php
@@ -0,0 +1,51 @@
+<?
+
+/**
+ *
+ * Demonstrates document checkout and checkin
+ *
+ * The contents of this file are subject to the KnowledgeTree Public
+ * License Version 1.1 ("License"); You may not use this file except in
+ * compliance with the License. You may obtain a copy of the License at
+ * http://www.knowledgetree.com/KPL
+ * 
+ * Software distributed under the License is distributed on an "AS IS"
+ * basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ * 
+ * The Original Code is: KnowledgeTree Open Source
+ * 
+ * The Initial Developer of the Original Code is The Jam Warehouse Software
+ * (Pty) Ltd, trading as KnowledgeTree.
+ * Portions created by The Jam Warehouse Software (Pty) Ltd are Copyright
+ * (C) 2007 The Jam Warehouse Software (Pty) Ltd;
+ * All Rights Reserved.
+ *
+ */
+
+require_once('../ktwsapi.inc.php');
+
+$ktapi = new KTWSAPI(KTWebService_WSDL);
+
+// change session to something that is in table 'active_sessions'
+
+$response = $ktapi->active_session('qekolkpkk9mq2nlc31ghndi1l2');
+if (PEAR::isError($response))
+{
+	print $response->getMessage();
+	exit;
+}
+
+$root = $ktapi->get_root_folder();
+
+$document = $root->add_document('c:/temp/test.doc');
+
+$document->checkout('going to update','c:/');
+
+$document->checkin('c:/test.doc','have updated',false);
+
+$ktapi->logout();
+ 
+?>
\ No newline at end of file
diff --git a/ktwsapi/examples/ktws_eg_create_folder.php b/ktwsapi/examples/ktws_eg_create_folder.php
new file mode 100644
index 0000000..667b570
--- /dev/null
+++ b/ktwsapi/examples/ktws_eg_create_folder.php
@@ -0,0 +1,52 @@
+<?
+
+/**
+ *
+ * Demonstrates creating a folder in an active session.
+ *
+ * The contents of this file are subject to the KnowledgeTree Public
+ * License Version 1.1 ("License"); You may not use this file except in
+ * compliance with the License. You may obtain a copy of the License at
+ * http://www.knowledgetree.com/KPL
+ * 
+ * Software distributed under the License is distributed on an "AS IS"
+ * basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ * 
+ * The Original Code is: KnowledgeTree Open Source
+ * 
+ * The Initial Developer of the Original Code is The Jam Warehouse Software
+ * (Pty) Ltd, trading as KnowledgeTree.
+ * Portions created by The Jam Warehouse Software (Pty) Ltd are Copyright
+ * (C) 2007 The Jam Warehouse Software (Pty) Ltd;
+ * All Rights Reserved.
+ *
+ */
+
+require_once('../ktwsapi.inc.php');
+
+$ktapi = new KTWSAPI(KTWebService_WSDL);
+
+// change session to something that is in table 'active_sessions'
+
+$response = $ktapi->active_session('qekolkpkk9mq2nlc31ghndi1l2');
+if (PEAR::isError($response))
+{
+	print $response->getMessage();
+	exit;
+}
+
+$root = $ktapi->get_root_folder();
+if (PEAR::isError($root))
+{
+	print $root->getMessage();
+	exit;
+}
+
+$folder = $root->add_folder('test folder');
+
+
+
+?>
\ No newline at end of file
diff --git a/ktwsapi/examples/ktws_eg_doc_info.php b/ktwsapi/examples/ktws_eg_doc_info.php
new file mode 100644
index 0000000..473ef17
--- /dev/null
+++ b/ktwsapi/examples/ktws_eg_doc_info.php
@@ -0,0 +1,60 @@
+<?
+
+/**
+ *
+ * Demonstrates using an active session and getting document info and metadata.
+ *
+ * The contents of this file are subject to the KnowledgeTree Public
+ * License Version 1.1 ("License"); You may not use this file except in
+ * compliance with the License. You may obtain a copy of the License at
+ * http://www.knowledgetree.com/KPL
+ * 
+ * Software distributed under the License is distributed on an "AS IS"
+ * basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ * 
+ * The Original Code is: KnowledgeTree Open Source
+ * 
+ * The Initial Developer of the Original Code is The Jam Warehouse Software
+ * (Pty) Ltd, trading as KnowledgeTree.
+ * Portions created by The Jam Warehouse Software (Pty) Ltd are Copyright
+ * (C) 2007 The Jam Warehouse Software (Pty) Ltd;
+ * All Rights Reserved.
+ *
+ */
+
+require_once('../ktwsapi.inc.php');
+
+$ktapi = new KTWSAPI(KTWebService_WSDL);
+
+// change session to something that is in table 'active_sessions'
+
+$response = $ktapi->active_session('qekolkpkk9mq2nlc31ghndi1l2');
+if (PEAR::isError($response))
+{
+	print $response->getMessage();
+	exit;
+}
+
+// lets ge the document based on id.
+
+$document = $ktapi->get_document_by_id(50);
+if (PEAR::isError($document))
+{
+	print $document->getMessage();
+	exit;
+}
+
+// lets get the document metadata
+
+$metadata = $document->get_metadata();
+if (PEAR::isError($metadata))
+{
+	print $metadata->getMessage();
+	exit;
+}
+var_dump($metadata);
+
+?>