diff --git a/API.md b/API.md
new file mode 100644
index 0000000..0cbaaaa
--- /dev/null
+++ b/API.md
@@ -0,0 +1,155 @@
+## API
+[Documents, pandora*, 0xdb2*)]TOC(heading=Design
+
+### Documentation
+Each instance of Pan.do/ra comes with its build in API documentation. You find it by navigation to /api/ with a browser.
+I.e. current API can be found at
+
+### Using the API
+To use the API you can use Ox.App if you use Ox.js, or look at [pandora_client](https://wiki.0x2620.org/browser/pandora_client/pandora_client/*init*.py#L331) for how this can be used from python. Eventually we hope to describe this section in more detail.
+
+
+
+### Examples
+
+
+#### PHP
+```
+url = $url;
+ }
+ public function _request($action, $data) {
+ $content = array(
+ 'action' => $action,
+ 'data' => json_encode($data)
+ );
+ $options = array(
+ 'http' => array(
+ 'header' => "Content-type: application/x-www-form-urlencoded\r\n",
+ 'method' => 'POST',
+ 'content' => http_build_query($content),
+ ),
+ );
+ $context = stream_context_create($options);
+ $result = json_decode(file_get_contents($this->url, false, $context));
+ return $result;
+ }
+}
+l
+$api = new API('http://archive.arabdigitalexpression.org/api/');
+
+$result = $api->_request('find', array(
+ "query"=>array(
+ "conditions"=>array(array("key"=>"*", "value"=>"paris", "operator"=>'='))
+ ),
+ "keys"=>array("title", 'id'),
+ "range"=> array(0, 10),
+ "sort"=>array(array("key"=>"title", "operator"=>"+"))
+));
+
+var_dump($result);
+
+```
+
+#### JavaScript
+```
+
+
+
+
+
+
+
+
+```
+
+Or using OxJS
+```
+
+
+
+
+
+
+
+
+
+```
+
+#### Python
+
+Using python-ox (install with **easy_install ox**)
+
+```
+import ox
+
+api = ox.API('http://archive.arabdigitalexpression.org/api/')
+
+item = api.find({'query':{conditions:[{'key': '*', 'value':'test', 'operator':'='}], 'operator':'&'}, 'keys': ['location']})
+
+```
+
+Add all items in list 'j:Example' to groups a, b and c
+```
+#!/usr/bin/python
+import ox
+
+username=ADD_USER
+password=ADD_PASSWORD
+groups = ['a', 'b', 'c']
+list_id = 'j:Example'
+
+api = ox.API('http://kjc-sv030.kjc.uni-heidelberg.de/api/')
+api.signin(username=username, password=password)
+for i in api.find({'query': {
+ 'conditions': [{'key': 'list', 'value': list_id}]},
+ 'keys': ['id', 'groups'],
+ 'range': [0, 10000]
+})['data']['items']:
+ if i['groups'] != groups:
+ print id
+ api.edit({'id': i['id'], 'groups': groups})
+```
\ No newline at end of file
diff --git a/DatabaseUpdate.md b/DatabaseUpdate.md
new file mode 100644
index 0000000..2b3dd16
--- /dev/null
+++ b/DatabaseUpdate.md
@@ -0,0 +1,43 @@
+## Upgrading Database to South
+first time you update from a version without South you have to manually sync your db and after that initialize your database and fake all previous south transactions:
+
+ 1. if your repositroy revision is below 2327, you want to update to 2327, migrate to south and update to latest version after that
+```
+bzr pull -r2327
+cd src/python-ox
+bzr pull
+```
+ 2. manualy sync database to current layout(see below)
+ 3. make sure south is installed
+```
+cd /srv/pandora
+./bin/pip install South
+```
+
+ 4. sync south db
+```
+cd /srv/pandora/pandora
+./manage.py syncdb
+```
+ 5. populate south history
+```
+./manage.py migrate --all --fake
+```
+
+## Manually Syncing Database
+First check for changes in the database:
+```
+cd /srv/pandora/pandora
+./manage.py sqldiff -a
+```
+If you have any you can pipe the diff into dbshell to apply them. make sure nothing gets dropped that contains data.
+```
+cd /srv/pandora/pandora
+./manage.py sqldiff -a | ./manage.py dbshell
+```
+Sometimes it is required to set defaults for rows. In that case you have to open dbshell and set them manually:
+```
+./manage.py dbshell
+UPDATE archive_file SET info = '{}' WHERE info IS NULL;
+UPDATE archive_file SET path_info = '{}' WHERE path_info IS NULL;
+```
\ No newline at end of file
diff --git a/IMDb.md b/IMDb.md
new file mode 100644
index 0000000..ba568fc
--- /dev/null
+++ b/IMDb.md
@@ -0,0 +1,126 @@
+## IMDb Parser
+[Documents, pandora*, 0xdb2*)]TOC(heading=Design
+
+Open Issues:
+
+ * some feelds need html stripped, others not
+ * tv shows have " around title
+ * lists of type, i.e. release_date can be a list of dates with current parser
+
+this is now implemented in python-ox
+[see here](http://code.0x2620.org/python-ox/annotate/head%3A/ox/web/imdb.py)
+
+```
+{
+ 'cast': {
+ 'page': 'combined',
+ 're': '