diff --git a/scripts/restore_postgresql.sh b/scripts/restore_postgresql.sh
index 727f5d69b890874ccd0c2605f77017a919eb2f90..0ee9990b28005639730cb3e7f0888694db1ed661 100755
--- a/scripts/restore_postgresql.sh
+++ b/scripts/restore_postgresql.sh
@@ -1,4 +1,15 @@
 #!/bin/bash
+#
+# Restores all databases (might throw errros, see pg docs).
+# Might require to regrant privileges or ownership of created objects.
+#
+# ```
+# \c database
+# GRANT ALL PRIVILEGES ON SCHEMA public TO y;
+# GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO y;
+# GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO y;
+# ```
+`
 set -ex
 umask 077