From d0d09604e1e958dce9fd2a4067eff77e5c9ecb29 Mon Sep 17 00:00:00 2001
From: Dmitry Verkhoturov <paskal.07@gmail.com>
Date: Sun, 6 Dec 2020 20:08:26 +0100
Subject: [PATCH] add remap doc by @mind-overflow #810

---
 docs/1.6/migration.md    | 30 ++++++++++++++++++++++++++++++
 docs/latest/migration.md | 30 ++++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+)
 create mode 100644 docs/1.6/migration.md
 create mode 100644 docs/latest/migration.md

diff --git a/docs/1.6/migration.md b/docs/1.6/migration.md
new file mode 100644
index 00000000..cd842824
--- /dev/null
+++ b/docs/1.6/migration.md
@@ -0,0 +1,30 @@
+---
+title: Site URL migration
+---
+
+Here is an example on how to move your comments after your posts are moved, from `https://example.org/blog/<slug>` to `https://example.org/post/<slug>` in that example.
+
+### Rules file
+
+First you have to create a `rules` file in remark's `/var` folder.
+
+[Here is the test](https://github.com/akosourov/remark/blob/4dc123dbe84f4f248864bcdbbd6cc2b3a4dafe11/backend/app/migrator/mapper_test.go#L13-L17) with an example of rules file syntax, format is simply `old_url new_url` like following:
+
+```
+https://example.org/old-url-1/ https://example.org/new-url-1/
+https://example.org/old-url-2/ https://example.org/new-url-2/
+```
+
+### Applying the remap
+
+After rules file is ready, run the following command:
+
+```sh
+remark42 remap --admin-passwd <password> -f var/rules
+```
+
+If running in a docker container, the command becomes:
+```sh
+docker ps # to find the container name
+docker exec -it <container> remark42 remap --admin-passwd <password> -f var/rules
+```
diff --git a/docs/latest/migration.md b/docs/latest/migration.md
new file mode 100644
index 00000000..cd842824
--- /dev/null
+++ b/docs/latest/migration.md
@@ -0,0 +1,30 @@
+---
+title: Site URL migration
+---
+
+Here is an example on how to move your comments after your posts are moved, from `https://example.org/blog/<slug>` to `https://example.org/post/<slug>` in that example.
+
+### Rules file
+
+First you have to create a `rules` file in remark's `/var` folder.
+
+[Here is the test](https://github.com/akosourov/remark/blob/4dc123dbe84f4f248864bcdbbd6cc2b3a4dafe11/backend/app/migrator/mapper_test.go#L13-L17) with an example of rules file syntax, format is simply `old_url new_url` like following:
+
+```
+https://example.org/old-url-1/ https://example.org/new-url-1/
+https://example.org/old-url-2/ https://example.org/new-url-2/
+```
+
+### Applying the remap
+
+After rules file is ready, run the following command:
+
+```sh
+remark42 remap --admin-passwd <password> -f var/rules
+```
+
+If running in a docker container, the command becomes:
+```sh
+docker ps # to find the container name
+docker exec -it <container> remark42 remap --admin-passwd <password> -f var/rules
+```