From cad78fe5e85f15de90a9604cc17fbc745e0e983d Mon Sep 17 00:00:00 2001
From: Thomas Sileo <t@a4.io>
Date: Tue, 6 Dec 2022 20:26:15 +0100
Subject: [PATCH] Document the new follows import task

---
 Makefile           |  4 ++++
 docs/user_guide.md | 22 ++++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/Makefile b/Makefile
index a413271..213c271 100644
--- a/Makefile
+++ b/Makefile
@@ -41,3 +41,7 @@ check-config:
 .PHONY: compile-scss
 compile-scss:
 	-docker run --rm --volume `pwd`/data:/app/data --volume `pwd`/app/static:/app/app/static microblogpub/microblogpub inv compile-scss
+
+.PHONY: import-mastodon-following-accounts 
+import-mastodon-following-accounts:
+	-docker run --rm --volume `pwd`/data:/app/data --volume `pwd`/app/static:/app/app/static microblogpub/microblogpub inv import-mastodon-following-accounts $(path)
diff --git a/docs/user_guide.md b/docs/user_guide.md
index 6bea721..363a5fa 100644
--- a/docs/user_guide.md
+++ b/docs/user_guide.md
@@ -344,6 +344,28 @@ also_known_as = "my@old-account.com"
 
 Restart the server, and you should be able to complete the move from your existing account.
 
+## Import follows from Mastodon
+
+You can import the list of follows/following accounts from Mastodon.
+
+It requires downloading the "Follows" CSV file from your Mastodon instance via "Settings" / "Import and export" / "Data export".
+
+Then you need to run the import task:
+
+### Python edition
+
+```bash
+# For a Python install
+poetry run inv import-mastodon-following-accounts following_accounts.csv
+```
+
+### Docker edition
+
+```bash
+# For a Docker install
+make path=following_accounts.csv import-mastodon-following-accounts
+```
+
 ## Tasks
 
 ### Configuration checking