From 615db75c3dbf7b9ece50551bbaa3bf1e8acdd0ab Mon Sep 17 00:00:00 2001
From: Jose Diaz-Gonzalez <email@josediazgonzalez.com>
Date: Mon, 13 Sep 2021 03:27:29 -0400
Subject: [PATCH] docs: document how to convert the data dump to plain sql

Closes #214
---
 README.md      | 6 ++++++
 docs/export.md | 5 +++++
 2 files changed, 11 insertions(+)
 create mode 100644 docs/export.md

diff --git a/README.md b/README.md
index e370cc2..fc04280 100644
--- a/README.md
+++ b/README.md
@@ -558,6 +558,12 @@ You can redirect this output to a file:
 dokku postgres:export lollipop > data.dump
 ```
 
+Note that the export will result in a file containing the binary postgres export data. It can be converted to plain text using `pg_restore` as follows
+
+```shell
+pg_restore data.dump -f plain.sql.
+```
+
 ### Backups
 
 Datastore backups are supported via AWS S3 and S3 compatible services like [minio](https://github.com/minio/minio).
diff --git a/docs/export.md b/docs/export.md
new file mode 100644
index 0000000..6e2eb52
--- /dev/null
+++ b/docs/export.md
@@ -0,0 +1,5 @@
+Note that the export will result in a file containing the binary postgres export data. It can be converted to plain text using `pg_restore` as follows
+
+```shell
+pg_restore data.dump -f plain.sql.
+```