diff --git a/README.md b/README.md
index e68592bd4b6907ffcfbde2f28a7cf00473408eff..e65d63e16803b39ac22a071117f770ce509061db 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
 # hpc_utilisation
 
-Python program to check the utilisation of HPC jobs using the PBS schedular.
\ No newline at end of file
+Python program to check the utilisation of HPC jobs using the PBS schedular.
+
+In the Python code the `users_db_name` is a small sqlite database that just contains user information.
+The schema is:
+
+    $ echo '.schema' | sqlite3 users_ldap_public.db
+    CREATE TABLE IF NOT EXISTS "users" ( 'id' INTEGER NOT NULL, 'uts_id' TEXT NOT NULL, 'uts_email' TEXT, 'name' TEXT, PRIMARY KEY('id'));
+
+