From a278c178b0ec19bead19ed3a96aadf3dbafa1b9a Mon Sep 17 00:00:00 2001
From: Hendrik Sokolowski <hensoko@gssws.de>
Date: Sun, 28 Apr 2024 02:01:34 +0200
Subject: [PATCH] docs: obs-portal: add prosaic sugar

---
 docs/obs-portal.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/obs-portal.md b/docs/obs-portal.md
index be4a274..a0ab53d 100644
--- a/docs/obs-portal.md
+++ b/docs/obs-portal.md
@@ -8,18 +8,25 @@
 
 ## Run database migrations
 
+After an upgrade it is sometimes necessary to run database migrations or regenerate tiles.
+
 ```
 docker exec -ti obs-portal tools/upgrade.py
 ```
 
 ## Dump database
 
+Save database dump to `dump.sql` in the current working directory.
+
 ```
-docker exec -ti --user postgres obs-portal-db pg_dump obs
+docker exec -ti --user postgres obs-portal-db pg_dump obs > dump.sql
 ```
 
 ## Restore database
 
+Load database dump from `dump.sql` file.
+`obs` database needs to exist before importing the dump.
+
 ```
 cat dump.sql | docker exec -ti --user postgres obs-portal-db psql obs
 ```