From 3ec4332b7c91e4b168bf7bdb338f86d3e56e2da5 Mon Sep 17 00:00:00 2001
From: Rafa de la Torre <rtorre@cartodb.com>
Date: Fri, 23 Oct 2015 16:05:08 +0200
Subject: [PATCH] A README for the extension

---
 geocoder/admin0/extension/README.md | 36 +++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 geocoder/admin0/extension/README.md

diff --git a/geocoder/admin0/extension/README.md b/geocoder/admin0/extension/README.md
new file mode 100644
index 0000000..96dd39a
--- /dev/null
+++ b/geocoder/admin0/extension/README.md
@@ -0,0 +1,36 @@
+# CartoDB admin0 geocoder extension
+Postgres extension for the CartoDB admin0 geocoder. It is meant to contain the functions and related objects needed to geocode by admin0 regions. It is not meant to contain the actual data used to geocode them.
+
+## Dependencies
+This extension is thought to be used on top of CartoDB platform. Therefore a cartodb user is required to install the extension onto it.
+
+The following is a non-comprehensive list of dependencies:
+
+- Postgres 9.3+
+- Postgis extension
+- Schema triggers extension
+- CartoDB extension
+
+## Installation into the db cluster
+This requires root privileges
+```
+sudo make all install
+```
+
+## Execute tests
+```
+PGUSER=postgres make installcheck
+```
+
+## Install onto a user's database
+```
+psql -U development_cartodb_user_fe3b850a-01c0-48f9-8a26-a82f09e9b53f cartodb_dev_user_fe3b850a-01c0-48f9-8a26-a82f09e9b53f_db
+```
+
+and then:
+
+```sql
+CREATE EXTENSION cdb_geocoder_admin0;
+```
+
+The extension creation in the user's db does not require special privileges. It can be even created from the sql api.