Add more docs

docs/docs/user-guide/customization/themed-icons.md

@@ -17,15 +17,12 @@ While themed icons were originally introduced in Android 13, support has been ba
 Note however, that some apps (especially preinstalled system apps) may not support themed icons on
 older Android versions.
 
-## Themed icon packs
+## Themable icon packs
 
 Some icon packs, notably [Lawnicons](https://github.com/LawnchairLauncher/lawnicons)
 and [Arcticons](https://github.com/Donnnno/Arcticons), have support
-for themed icons. This is indicated by a "Dynamic colors" badge in the icon pack selection dialog.
-After you have selected an icon pack with support for themed icons, you can enable themed icons for
-that pack using the toggle button that appears in the icon pack preference:
-
-![Themed icon pack](/img/themed-icon-pack.png)
+for themed icons. This is indicated by a <span class="material-symbols-rounded">palette</span> icon
+in the icon pack selection dialog.
 
 > [!NOTE]
 > If you are an icon pack developer, you can indicate that your icon pack supports themed icons by

docs/docs/user-guide/faq.md

@@ -8,24 +8,44 @@ sidebar_position: 2
 
 There are two options:
 
-1. Go to Settings > Home screen > Clock and enable "Favorites". This will display the first row of pinned items
+1. Go to Settings > Home screen > Clock and enable "Favorites". This will display the first row of
+   pinned items
    as part of the clock widget.
 
-2. Scroll down to the end of the widgets list, select "Edit widgets" > "Add widget" > "Favorites" to add
+2. Scroll down to the end of the widgets list, select "Edit widgets" > "Add widget" > "Favorites" to
+   add
    the favorites widget to the home screen.
 
 ## Can I remove / customize the clock?
 
-Yes, you can customize the clock style by going to Settings > Home screen > Clock and selecting a different
+Yes, you can customize the clock style by going to Settings > Home screen > Clock and selecting a
+different
 style. There is also an "empty style" that will remove the clock entirely.
 
 ## The toggle to grant notification access or to enable the accessibility service is disabled
 
-Please refer to the [Restricted Settings on Android 13+](/docs/user-guide/troubleshooting/restricted-settings) page.
+Please refer to
+the [Restricted Settings on Android 13+](/docs/user-guide/troubleshooting/restricted-settings) page.
 
 ## The launcher keeps asking for notification access or accessibility service
 
-Please refer to the [this page](/docs/user-guide/troubleshooting/granted-permissions).
+Please refer to [this page](/docs/user-guide/troubleshooting/granted-permissions).
+
+## I can't update to the latest version
+
+Please refer to the [Launcher Cannot Be Updated](/docs/user-guide/troubleshooting/update-not-installed) page.
+
+## Why is wallpaper blur not supported on my device?
+
+Wallpaper blur is available if:
+
+- the device runs Android 12 or higher
+- battery saver is not enabled
+
+Furthermore, the device has to have support for [cross window
+blur](https://source.android.com/docs/core/display/window-blurs). This is a flag that has to
+be enabled by the device manufacturer to indicate that their implementation of the render engine
+supports blur effects and that the GPU is powerful enough to handle them.
 
 ## How can I set up the nightly version?
 

docs/docs/user-guide/sidebar.ts

@@ -117,6 +117,10 @@ export const UserGuideSidebar: DefaultTheme.SidebarItem[] = [
         text: 'Restricted Settings on Android 13+',
         link: '/docs/user-guide/troubleshooting/restricted-settings',
       },
+      {
+        text: 'Launcher Cannot Be Updated',
+        link: '/docs/user-guide/troubleshooting/update-not-installed',
+      },
     ],
   },
 ]

docs/docs/user-guide/troubleshooting/update-not-installed.md

@@ -0,0 +1,31 @@
+# Launcher Cannot Be Updated
+
+If you are trying to update the launcher, but the installation fails, you are most likely trying
+to crossgrade from the F-Droid version to the Github version or vice versa. Both versions use
+different signing keys, so you cannot update one with the other.
+
+## Kvaesitso versions
+
+There are two different release versions of Kvaesitso:
+
+- **Github version**: This is the version that is released on Github. It includes all features and
+  is also available on
+  the [MM20 F-Droid repository](https://fdroid.mm20.de/app/de.mm20.launcher2.release) and on
+  the [IzzyOnDroid F-Droid repository](https://apt.izzysoft.de/fdroid/index/apk/de.mm20.launcher2.release).
+- **F-Droid version**: This version is built and signed, and distributed by the F-Droid maintainers.
+  It is available on
+  the [official F-Droid repository](https://f-droid.org/packages/de.mm20.launcher2.release). Some
+  features disabled that depend on external APIs; most notably, there are fewer
+  weather providers available. Furthermore, new versions are usually released with a delay (a few
+  days up to a week).
+
+## Check which version you have installed
+
+Go to Settings > About. If the version number is something like `x.y.z`, you have the Github version
+installed. If the version number ends in `-fdroid`, you have the F-Droid version installed.
+
+## Switch between versions
+
+You cannot switch versions without uninstalling the current version first. First, backup your
+data in Settings > Backup & restore. Then, uninstall the current version and install the other
+version. You can then restore your data in Settings > Backup & restore > Restore.