Importing book data and migration accounts

content/using_bookwyrm/adding-books.md

@@ -6,9 +6,23 @@ Order: 2
 
 There are a few different ways to add books to your BookWyrm instance! When you can't find the book you're looking for, try these options in order -- it's better to import a book than to create one from scratch.
 
+## Importing data about your books and reading
+
+If you're coming to BookWyrm from another platform for tracking books and reading, you may want to import your books and reading data. Currently BookWyrm is capable of importing export files from the following platforms:
+
+* Calibre (CSV)
+* Goodreads (CSV)
+* LibraryThing (TSV)
+* OpenLibrary (CSV)
+* Storygraph (CSV)
+
+Under 'Settings' navigate to 'Import Book List', select the matching data source, select your file and, if relevant, select whether to import reviews and what privacy setting to give them. When you press 'Import' a background task will begin to import your data. You will be notified when it has finished.
+
+It is important to understand that the import process does not import data directly from the other service - in many cases (e.g. Goodreads) this is not possible. When you import a data file, BookWyrm will search the local database, connected BookWyrm servers, and selected public data sources to find a match. For this reason, BookWyrm may not be able to import all of your data. We are always looking for new data sources with free and open APIs, especially for data about books in languages other than English. If you are aware of such a data source, please consider [creating an Issue](https://github.com/bookwyrm-social/bookwyrm/issues),
+
 ## Loading books from other catalogs
 
-If the book you're looking for isn't available on your instance, there are a few different ways to add it. The best way is to import it from an outside source -- your instance can load books from other BookWyrm instances, as well as [OpenLibrary](http://openlibrary.org/) and [Inventaire](http://inventaire.io/). If there are no search results for your query, these sources will automatically be queried, and will show up with a button to "**Import book**". If there are local search results that aren't what you're looking for, you can click the "**Load results from other catalogues**" link to load more results.
+If the book you're looking for isn't available on your BookWyrm instance, there are a few different ways to add it. The best way is to import it from an outside source -- your instance can load books from other BookWyrm instances, as well as [OpenLibrary](http://openlibrary.org/) and [Inventaire](http://inventaire.io/). If there are no search results for your query, these sources will automatically be queried, and will show up with a button to "**Import book**". If there are local search results that aren't what you're looking for, you can click the "**Load results from other catalogues**" link to load more results.
 
 
 ## Adding another edition

content/using_bookwyrm/user-migration.md

@@ -0,0 +1,59 @@
+---
+Title: User migration and aliases
+Date: 2024-01-06
+Order: 3
+---
+
+You can migrate your account between BookWyrm instances, and/or set up an _alias_ between any ActivityPub account and your BookWyrm acccount.
+
+## Exporting account data
+
+You can export your account data at any time, however there will be a limit on how often you can do this, set by your instance admin. When you create an export file a process will run in the background and you will be notified when it is completed and ready for download. Export files are in `tar.gz` format.
+
+Account export files include:
+
+* User profile and avatar
+* Most user settings
+* Reading goals
+* Shelves
+* Reading history
+* Book reviews
+* Statuses
+* Your own lists and saved lists
+* Which users you follow and block
+
+Exports do _not_ include:
+
+* Direct messages
+* Replies to your statuses
+* Groups
+* Favorites
+
+## Aliases
+
+An _alias_ indicates to ActivityPub software that two accounts represent and are controlled by the same person. You can assign any ActivityPub account as an alias of your BookWyrm account by navigating to `Settings - Aliases`.
+
+Setting an account as an alias is easily reversible, and is required to migrate accounts.
+
+## Moving an account
+
+You can "move" an account from one to another at `Settings - Move Account`. Moving your account will notify all your followers and direct them to follow the new (target) account - including followers from non-BookWyrm servers. If you also want to move your user data, see "Importing account data" below.
+
+Your old (origin) account will be marked as moved and will not be discoverable or usable unless you undo the move, which you can do at any time, however any followers who have migrated their follow from the old account to the new account will no longer be following your old account.
+
+You _must_ set the old (source) user as an alias of the new (target) user in the settings of the target account for a `Move` to work.
+
+## Importing account data
+
+Once you have an export file you can import it into another BookWyrm instance. To do so, you must first set the new (target) account as an alias of the old (source) account, or `Move` the old account to the new one.
+
+It is important to read the instructions on the account import page as some data will be overwritten if selected. There is also a limit on how often you can import user data.
+
+* Go to `Settings - Import BookWyrm Account`
+* Select your export file
+* Untick any data options you do not wish to import
+* Click 'Import'
+
+Your import will run in the background and you will be notified when it is completed.
+
+If you import data from an account on the same server, all posts (comments, reviews, quotations) will be re-assigned to the new user.