Merge pull request #227 from hughrun/settings

add settings page

Author: hughrun

content/using_bookwyrm/lists.md

@@ -1,7 +1,7 @@
 ---
 Title: Lists
 Date: 2025-05-26
-Order: 5
+Order: 6
 ---
 
 Lists in Bookwyrm are a way to organise and display similar books together.
@@ -12,7 +12,7 @@ To see your Lists, click 'Your Lists' below the title or navigate to your profil
 ## Creating a List
 
 To create a List, first select the 'Create List' button on the top right of the page.
-It needs a name, and you can optionally add a description. 
+It needs a name, and you can optionally add a description.
 You will then choose how you'd like to curate the List.
 
 ## List curation
@@ -26,7 +26,7 @@ There are four options for List curation:
 
 ## List privacy
 
-Lists have similar privacy levels as other things in Bookwyrm: Public, Unlisted, Followers and Private. 
+Lists have similar privacy levels as other things in Bookwyrm: Public, Unlisted, Followers and Private.
 See more details on the [privacy controls](/privacy-controls.html#lists) page.
 
 ## Adding books to a List

content/using_bookwyrm/posting-statuses.md

@@ -1,7 +1,7 @@
 ---
 Title: Posting Statuses
 Date: 2025-05-26
-Order: 4
+Order: 5
 ---
 
 Posting on BookWyrm starts with a book.

content/using_bookwyrm/settings.md

@@ -0,0 +1,78 @@
+---
+Title: Settings and Profile
+Date: 2025-10-12
+Order: 4
+---
+
+You can control your account and profile settings by activating the dropdown menu below your username and selecting `Settings`.
+
+## Edit Profile
+
+### Profile
+
+* Upload or remove your user avatar
+* Change your display name
+* Create or edit your user summary (bio or description)
+* Change your registered email address
+
+### Display
+
+* Choose whether to show reading goal prompt in feed
+* Choose whether to show ratings in reviews, or have them hidden behind a toggle by default
+* Choose whether BookWyrm should suggest users to follow
+* Choose whether BookWyrm can suggest your user account to others
+* Select your timezone - this affects the time stamps displayed to you
+* Select your user interface language
+* Select a theme - different instances will have different options, by default there are BookWyrm light and dark themes
+
+### Privacy
+
+* Choose whether followers must be approved by you before following your account
+* Choose whether to hide followers and following on your user profile
+* Choose your default post privacy. Find [more detail about what the post privacy options mean](/privacy-controls.html) on the Privacy Controls page
+
+## Change Password
+
+Here you can ...change your password
+
+## Account Security
+
+We recommend you protect your account with second-factor authentication using an authenticator app.
+
+This section also allows you to see all the logged-in sessions for your user account, and terminate them. This can be a useful way to protect your account if you have, for example, lost a device, or do not recognise a session.
+
+## Aliases and moving your account
+
+You can set an "alias" for your account, indicating that they represent the same "actor". This is usually done when you want to migrate your account from one fediverse account to another.
+
+You can also move (migrate) your account using `Move Account`. You must set the account you are moving _from_ as an alias of the account you are moving _to_ before attempting to move the account.
+
+Setting an alias is easily reversable. Moving your account is not - choose wisely!
+
+See [User Migration and Aliases](user-migration.html) for more details.
+
+## Deactivating or deleting your account
+
+Under `Delete Account` you can either deactivate or delete your account.
+
+Deactivating marks your account as no longer active and hides your profile page. You can re-activate your account in future.
+
+Deleting your account is irreversable. Your username will not be available to register in the future. Note that on deleting your account, BookWyrm will attempt to delete all user data and posts, however it is possible that federated servers may not process the deletion correctly.
+
+Books that were added by a deleted user will remain available as they conceptually exist separately from any individual user or shelf.
+
+## Importing and Exporting books
+
+Under the `Data` heading, you can import and export book lists.
+
+See [Adding Books](/adding-books.html) for more information about importing books. Choose `Export Book List` to export a CSV file including all the books on your shelves, books you have reviewed, and books with reading activity.
+
+You can also import or export a user account from this section. See [User Migration and Aliases](user-migration.html) for more details.
+
+## Blocking users
+
+You can block or unblock a user by selecting the ellipses (...) on the right of the "Follow/Unfollow" button on their profile.
+
+If you have blocked any users, they will be listed under `Blocked Users` and can be unblocked from there.
+
+Blocked users cannot see your profile, lists, or shelves, send you DMs, or see or interact with your posts.