From dc20ee4420dc16838c74eefd4cb101d0455ae0bd Mon Sep 17 00:00:00 2001
From: arkon <arkon@users.noreply.github.com>
Date: Sun, 10 Sep 2023 14:36:07 -0400
Subject: [PATCH] Reorganize FAQs (#47)

---
 .../.vitepress/config/navigation/sidebar.ts   |  65 ++++++++----------
 .../docs/faq/{application => }/android-11+.md |   0
 website/src/docs/faq/application/index.md     |  25 -------
 .../src/docs/faq/application/miscellaneous.md |  22 ------
 website/src/docs/faq/application/shizuku.md   |  29 --------
 .../src/docs/faq/{ => browse}/extensions.md   |  22 +++---
 .../faq/{application => }/browse/index.md     |   0
 .../{application => }/browse/local-source.md  |   0
 .../docs/faq/{application => }/downloads.md   |   0
 website/src/docs/faq/general.md               |  10 +--
 .../src/docs/faq/{application => }/library.md |  17 +++++
 .../src/docs/faq/{application => }/reader.md  |   0
 website/src/docs/faq/settings.md              |  22 ++++++
 website/src/docs/guides/getting-started.md    |   2 +-
 website/src/docs/guides/shizuku.md            |  16 +++++
 .../guides/troubleshooting/common-issues.md   |   2 +-
 .../extensions/unknown-sources-A10.light.webm | Bin
 .../extensions/unknown-sources-A7.light.webm  | Bin
 18 files changed, 103 insertions(+), 129 deletions(-)
 rename website/src/docs/faq/{application => }/android-11+.md (100%)
 delete mode 100644 website/src/docs/faq/application/index.md
 delete mode 100644 website/src/docs/faq/application/miscellaneous.md
 delete mode 100644 website/src/docs/faq/application/shizuku.md
 rename website/src/docs/faq/{ => browse}/extensions.md (81%)
 rename website/src/docs/faq/{application => }/browse/index.md (100%)
 rename website/src/docs/faq/{application => }/browse/local-source.md (100%)
 rename website/src/docs/faq/{application => }/downloads.md (100%)
 rename website/src/docs/faq/{application => }/library.md (78%)
 rename website/src/docs/faq/{application => }/reader.md (100%)
 create mode 100644 website/src/docs/faq/settings.md
 create mode 100644 website/src/docs/guides/shizuku.md
 rename website/src/public/docs/faq/{ => browse}/extensions/unknown-sources-A10.light.webm (100%)
 rename website/src/public/docs/faq/{ => browse}/extensions/unknown-sources-A7.light.webm (100%)

diff --git a/website/src/.vitepress/config/navigation/sidebar.ts b/website/src/.vitepress/config/navigation/sidebar.ts
index 31611bb3..bbe177df 100644
--- a/website/src/.vitepress/config/navigation/sidebar.ts
+++ b/website/src/.vitepress/config/navigation/sidebar.ts
@@ -41,48 +41,37 @@ function defaultSidebar(): DefaultTheme.SidebarItem[] {
 			items: [
 				{ text: "General", link: "/docs/faq/general" },
 				{
-					text: "Application",
-					link: "/docs/faq/application/",
+					text: "Library",
+					link: "/docs/faq/library",
+				},
+				{
+					text: "Browse",
+					link: "/docs/faq/browse/",
 					collapsed: true,
 					items: [
+						{ text: "Extensions", link: "/docs/faq/browse/extensions" },
 						{
-							text: "Library",
-							link: "/docs/faq/application/library",
-						},
-						{
-							text: "Browse",
-							link: "/docs/faq/application/browse/",
-							collapsed: true,
-							items: [
-								{
-									text: "Local source",
-									link: "/docs/faq/application/browse/local-source",
-								},
-							],
-						},
-						{
-							text: "Downloads",
-							link: "/docs/faq/application/downloads",
-						},
-						{
-							text: "Reader",
-							link: "/docs/faq/application/reader",
-						},
-						{
-							text: "Android 11+",
-							link: "/docs/faq/application/android-11+",
-						},
-						{
-							text: "Shizuku",
-							link: "/docs/faq/application/shizuku",
-						},
-						{
-							text: "Miscellaneous",
-							link: "/docs/faq/application/miscellaneous",
+							text: "Local source",
+							link: "/docs/faq/browse/local-source",
 						},
 					],
 				},
-				{ text: "Extensions", link: "/docs/faq/extensions" },
+				{
+					text: "Downloads",
+					link: "/docs/faq/downloads",
+				},
+				{
+					text: "Reader",
+					link: "/docs/faq/reader",
+				},
+				{
+					text: "Settings",
+					link: "/docs/faq/settings",
+				},
+				{
+					text: "Android 11+",
+					link: "/docs/faq/android-11+",
+				},
 			],
 		},
 		{
@@ -129,6 +118,10 @@ function defaultSidebar(): DefaultTheme.SidebarItem[] {
 					text: "Reader settings",
 					link: "/docs/guides/reader-settings",
 				},
+				{
+					text: "Shizuku",
+					link: "/docs/guides/shizuku",
+				},
 			],
 		},
 	]
diff --git a/website/src/docs/faq/application/android-11+.md b/website/src/docs/faq/android-11+.md
similarity index 100%
rename from website/src/docs/faq/application/android-11+.md
rename to website/src/docs/faq/android-11+.md
diff --git a/website/src/docs/faq/application/index.md b/website/src/docs/faq/application/index.md
deleted file mode 100644
index dedc4dae..00000000
--- a/website/src/docs/faq/application/index.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: Application - FAQ
-description: Frequently Asked Questions about the Application.
----
-
-# Application
-Frequently Asked Questions about the Application.
-
-## What is Tachiyomi Preview?
-
-**Tachiyomi Preview** is a regularly updated beta version of the app.
-It showcases potential upcoming features, but it's more prone to bugs and crashes.
-
-Ideal for users seeking the latest **Tachiyomi** experience, it's essential to [enable auto-backup](/docs/guides/backups#enabling-automatic-backups) to prevent library loss due to issues.
-
-## Why aren't library updates working?
-
-Some Android skins (e.g., **MIUI**) aggressively save battery, potentially shutting down apps in the background.
-
-Whitelist **Tachiyomi** from your battery saver by going to <nav to="advanced"> and tapping **Disable battery optimization**.
-
-If unsuccessful, try [DontKillMyApp](https://dontkillmyapp.com/) for battery-saving options on your device and workarounds.
-
-## Why is taking screenshots blocked?
-Turn off **Secure Screen** in <nav to="security-and-privacy">.
diff --git a/website/src/docs/faq/application/miscellaneous.md b/website/src/docs/faq/application/miscellaneous.md
deleted file mode 100644
index 201ab3a4..00000000
--- a/website/src/docs/faq/application/miscellaneous.md
+++ /dev/null
@@ -1,22 +0,0 @@
----
-title: Miscellaneous - FAQ
-description: Frequently Asked Questions that don't fit other categories.
----
-
-# Miscellaneous
-Frequently Asked Questions that don't fit other categories.
-
-## How do I pause reading history?
-Activate **Incognito Mode** through <nav to="incognito-mode">.
-
-## Reading downloaded chapters only
-Activate **Download only** via <nav to="downloaded-only">.
-
-## Understanding DNS over HTTPS
-**DNS over HTTPS (DoH)** offers secure DNS resolution through HTTPS, preventing attacks.
-Learn more [here](https://www.cloudflare.com/learning/dns/dns-over-tls/).
-
-Enable in <nav to="advanced">.
-
-## Automatic library backup and data transfer
-Learn about automatic backup and restore [here](/docs/guides/backups) and enabling auto backups [here](/docs/guides/backups#enabling-automatic-backups).
diff --git a/website/src/docs/faq/application/shizuku.md b/website/src/docs/faq/application/shizuku.md
deleted file mode 100644
index 3af7e9a9..00000000
--- a/website/src/docs/faq/application/shizuku.md
+++ /dev/null
@@ -1,29 +0,0 @@
----
-title: Shizuku
-description: Using Shizuku with Tachiyomi.
----
-
-# Shizuku
-**Shizuku** is an alternative method for installing and updating extensions in **Tachiyomi**.
-
-It taps into system APIs to directly install packages without requiring user interaction.
-
-To get a detailed understanding of **Shizuku**, its purpose, and how it operates, refer to the information provided [here](https://shizuku.rikka.app/introduction/).
-
-## Is Shizuku necessary?
-No. It can be considered if you wish to bypass installation prompts during extension setup.
-
-## Setting up Shizuku
-To set up **Shizuku**, follow the instructions [here](https://shizuku.rikka.app/guide/setup/).
-
-After configuring it, activate **Shizuku** within **Tachiyomi** by navigating to <nav to="advanced"> then changing the **Installer** setting.
-
-## Comparing installers
-Three installer options are available:
-
-* **Legacy**: A fallback installer if the standard **PackageInstaller** doesn't work.
-  > This is the default for **MIUI** (i.e. Xiaomi devices).
-* **PackageInstaller**: The primary installer option with additional features dependent on the Android version.
-  > For instance, it can bypass user prompts when updating extensions on **Android 12**.
-* **Shizuku**: Refer to the above section for details on **Shizuku**'s functionality.
-* **Private**: Installs directly to your device without passing as an application.
diff --git a/website/src/docs/faq/extensions.md b/website/src/docs/faq/browse/extensions.md
similarity index 81%
rename from website/src/docs/faq/extensions.md
rename to website/src/docs/faq/browse/extensions.md
index 7e424df3..eda51344 100644
--- a/website/src/docs/faq/extensions.md
+++ b/website/src/docs/faq/browse/extensions.md
@@ -6,8 +6,7 @@ description: Frequently Asked Questions about Extensions.
 # Extensions
 Frequently Asked Questions about Extensions.
 
-## Recommended extensions and sources
-
+## What are some recommended extensions and sources?
 **Tachiyomi** does not endorse or recommend any source, and there is no best extension.
 
 Instead, we encourage users to spend some time trying out a few sources themselves and discover what sources work best for them.
@@ -17,12 +16,12 @@ What works well for somebody else might not work well for you.
 **Tachiyomi** isn't responsible for slow, down, missing chapters, or subpar image quality of sources as it doesn't host content.
 :::
 
-## Scanlator sources
+## What is a scanlator source?
 Non-officially licensed series are translated by scanlators, often found on their websites or [MangaDex](https://mangadex.org/).
 Compare with official sources like [MANGA Plus By SHUEISHA](https://mangaplus.shueisha.co.jp) or [VIZ Shonen Jump](https://www.viz.com/shonenjump).
 Learn more in this [Wikipedia article](https://en.wikipedia.org/wiki/Scanlation).
 
-## Requesting new extensions
+## How do I request new extensions?
 [Open an issue](https://github.com/tachiyomiorg/tachiyomi-extensions/issues) on **GitHub** if not already there.
 Check the removed [extensions list](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475) first.
 
@@ -35,7 +34,7 @@ When prompted while installing your first extension, allow unknown apps installa
 
 ::: details Video guide - Recorded on Android 10
 <video controls muted preload="metadata">
-	<source src="/docs/faq/extensions/unknown-sources-A10.light.webm" type="video/webm">
+	<source src="/docs/faq/browse/extensions/unknown-sources-A10.light.webm" type="video/webm">
 </video>
 :::
 
@@ -47,20 +46,20 @@ When prompted while installing your first extension, allow unknown apps installa
 
 ::: details Video guide - Recorded on Android 7
 <video controls muted preload="metadata">
-	<source src="/docs/faq/extensions/unknown-sources-A7.light.webm">
+	<source src="/docs/faq/browse/extensions/unknown-sources-A7.light.webm">
 </video>
 :::
 ::::
 
-## Uninstalling an extension
+## How do I uninstall an extension?
 Uninstall extensions like regular apps: through device settings or in **Tachiyomi**.
 
-::: tip Uninstalling an Extension
+::: tip Uninstalling an extension
 In **Tachiyomi**, uninstall an extension via <nav to="extensions">, then tap **Uninstall** on the chosen extension.
 :::
 
-## Removed extensions
-Extensions can disappear due to several reasons:
+## Why was an extension removed?
+Extensions can be removed due to several reasons:
 
 * Frequent website changes.
 * Image scrambling.
@@ -68,4 +67,5 @@ Extensions can disappear due to several reasons:
 * Paywall implementation.
 * Reverse engineering needs.
 * Site shutdown.
-* Find the list of removed extensions [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475), excluding offline sites.
+
+Find the list of removed extensions [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475), excluding offline sites.
diff --git a/website/src/docs/faq/application/browse/index.md b/website/src/docs/faq/browse/index.md
similarity index 100%
rename from website/src/docs/faq/application/browse/index.md
rename to website/src/docs/faq/browse/index.md
diff --git a/website/src/docs/faq/application/browse/local-source.md b/website/src/docs/faq/browse/local-source.md
similarity index 100%
rename from website/src/docs/faq/application/browse/local-source.md
rename to website/src/docs/faq/browse/local-source.md
diff --git a/website/src/docs/faq/application/downloads.md b/website/src/docs/faq/downloads.md
similarity index 100%
rename from website/src/docs/faq/application/downloads.md
rename to website/src/docs/faq/downloads.md
diff --git a/website/src/docs/faq/general.md b/website/src/docs/faq/general.md
index c32796c6..ee08bdcc 100644
--- a/website/src/docs/faq/general.md
+++ b/website/src/docs/faq/general.md
@@ -20,6 +20,12 @@ Porting is difficult due to the separate codebases of iOS and Android apps.
 
 Any app proclaiming to be "**Tachiyomi for iOS**" is not by us and should be treated as a scam.
 
+## What is Tachiyomi Preview?
+**Tachiyomi Preview** is a regularly updated beta version of the app.
+It showcases potential upcoming features, but it's more prone to bugs and crashes.
+
+Ideal for users seeking the latest **Tachiyomi** experience, it's essential to [enable auto-backup](/docs/guides/backups#enabling-automatic-backups) to prevent library loss due to issues.
+
 ## How do I update from the F-Droid builds?
 **Tachiyomi** on **F-Droid** lacks official support, updates aren't guaranteed.
 
@@ -41,9 +47,5 @@ Refer to [this GitHub comment](https://github.com/tachiyomiorg/tachiyomi/issues/
 
 Projects using the **Tachiyomi** name for anime streaming aren't affiliated with the main project.
 
-## Can I sync between multiple devices?
-**Tachiyomi** can't sync between devices.
-Use its [backup and restore](/docs/guides/backups) features for series database and content migration to another device.
-
 ## What's a fork?
 Forks are alternate **Tachiyomi** versions with distinct features. Get more details here.
diff --git a/website/src/docs/faq/application/library.md b/website/src/docs/faq/library.md
similarity index 78%
rename from website/src/docs/faq/application/library.md
rename to website/src/docs/faq/library.md
index e1845529..ca6a51c0 100644
--- a/website/src/docs/faq/application/library.md
+++ b/website/src/docs/faq/library.md
@@ -35,6 +35,17 @@ To mitigate these concerns:
   * Update only the Reading category by navigating to <nav to="library">, then tap **Categories** under **Global update**.
   * If the warning persists, create a new category for infrequently updated entries (like monthly series or those on hiatus) and set global updates to target the more frequently updated reading category.
 
+## Why aren't library updates working?
+Some Android skins (e.g., **MIUI**) aggressively save battery, potentially shutting down apps in the background.
+
+Whitelist **Tachiyomi** from your battery saver by going to <nav to="advanced"> and tapping **Disable battery optimization**.
+
+If unsuccessful, refer to [DontKillMyApp](https://dontkillmyapp.com/) for battery-saving options on your device and workarounds.
+
+## Can I sync between multiple devices?
+**Tachiyomi** can't sync between devices.
+Use its [backup and restore](/docs/guides/backups) features, including [auto backups](/docs/guides/backups#enabling-automatic-backups), for series database and content migration to another device.
+
 ## How can I ignore duplicate chapters?
 Dealing with series translated by multiple groups that result in duplicate chapter releases?
 
@@ -55,5 +66,11 @@ Refresh your covers at <nav to="advanced"> then tap **Refresh library covers**.
 If certain series chapters are marked as unread without your interaction, it could be due to changed URLs.
 **Tachiyomi** detects these changes and interprets the chapters as new.
 
+## How do I pause reading history?
+Activate **Incognito Mode** through <nav to="incognito-mode">.
+
+## How do I only read downloaded chapters?
+Activate **Download only** via <nav to="downloaded-only">.
+
 ## Why can't I disable the Downloaded filter?
 Deactivate **Download only** via <nav to="downloaded-only">.
diff --git a/website/src/docs/faq/application/reader.md b/website/src/docs/faq/reader.md
similarity index 100%
rename from website/src/docs/faq/application/reader.md
rename to website/src/docs/faq/reader.md
diff --git a/website/src/docs/faq/settings.md b/website/src/docs/faq/settings.md
new file mode 100644
index 00000000..17a3bee7
--- /dev/null
+++ b/website/src/docs/faq/settings.md
@@ -0,0 +1,22 @@
+---
+title: Settings
+description: Frequently Asked Questions about various settings.
+---
+
+# Settings
+
+## Why is taking screenshots blocked?
+Turn off **Secure Screen** in <nav to="security-and-privacy">.
+
+## What is DNS over HTTPS?
+**DNS over HTTPS (DoH)** (in <nav to="advanced">) offers secure DNS resolution through HTTPS, preventing attacks.
+Learn more [here](https://www.cloudflare.com/learning/dns/dns-over-tls/). This may help bypass some basic website blocking.
+
+## What are the different installers?
+Three installer options are available (in <nav to="advanced">):
+
+* **Legacy**: A fallback installer if the standard **PackageInstaller** doesn't work.
+  > This is the default for **MIUI** (i.e. Xiaomi devices).
+* **PackageInstaller**: The primary installer option with additional features dependent on the Android version.
+  > For instance, it can bypass user prompts when updating extensions on **Android 12**.
+* **Shizuku**: Refer to the [Shizuku guide](/docs/guides/shizuku) for details on **Shizuku**'s functionality.
diff --git a/website/src/docs/guides/getting-started.md b/website/src/docs/guides/getting-started.md
index e2c0e352..6805ed6f 100644
--- a/website/src/docs/guides/getting-started.md
+++ b/website/src/docs/guides/getting-started.md
@@ -34,7 +34,7 @@ Depending on your device settings, you might need to grant **Tachiyomi** permiss
 
 ![Security warning](/docs/guides/getting-started/security-warning.webp =546x165)
 
-> Relevant guide: [Enabling Third-Party Installations](/docs/faq/extensions#enabling-third-party-installations)
+> Relevant guide: [Enabling Third-Party Installations](/docs/faq/browse/extensions#enabling-third-party-installations)
 :::
 
 ### 3. Adding series to your library
diff --git a/website/src/docs/guides/shizuku.md b/website/src/docs/guides/shizuku.md
new file mode 100644
index 00000000..dcf8002e
--- /dev/null
+++ b/website/src/docs/guides/shizuku.md
@@ -0,0 +1,16 @@
+---
+title: Shizuku
+description: Using Shizuku with Tachiyomi.
+---
+
+# Shizuku
+**Shizuku** is an alternative method for installing and updating extensions in **Tachiyomi**.
+
+It taps into system APIs to directly install packages without requiring user interaction.
+
+To get a detailed understanding of **Shizuku**, its purpose, and how it operates, refer to the information provided [here](https://shizuku.rikka.app/introduction/).
+
+## Setting up Shizuku
+To set up **Shizuku**, follow the instructions [here](https://shizuku.rikka.app/guide/setup/).
+
+After configuring it, activate **Shizuku** within **Tachiyomi** by navigating to <nav to="advanced"> then changing the **Installer** setting.
diff --git a/website/src/docs/guides/troubleshooting/common-issues.md b/website/src/docs/guides/troubleshooting/common-issues.md
index e0a47edb..c9593a39 100644
--- a/website/src/docs/guides/troubleshooting/common-issues.md
+++ b/website/src/docs/guides/troubleshooting/common-issues.md
@@ -17,7 +17,7 @@ Here's how to tackle common challenges.
 * Else, delete **Tachiyomi** downloads folder on SD card.
 
 ### Storage issues with Android 11+
-See [this](/docs/faq/application/android-11+) section of the FAQ to learn how Scoped Storage affects **Tachiyomi** in **Android 11+** and how to fix it.
+See [this](/docs/faq/android-11+) section of the FAQ to learn how Scoped Storage affects **Tachiyomi** in **Android 11+** and how to fix it.
 
 ### Slow loading
 Sources being slow could stem from site slowness, your internet, or source-imposed rate limits/IP bans.
diff --git a/website/src/public/docs/faq/extensions/unknown-sources-A10.light.webm b/website/src/public/docs/faq/browse/extensions/unknown-sources-A10.light.webm
similarity index 100%
rename from website/src/public/docs/faq/extensions/unknown-sources-A10.light.webm
rename to website/src/public/docs/faq/browse/extensions/unknown-sources-A10.light.webm
diff --git a/website/src/public/docs/faq/extensions/unknown-sources-A7.light.webm b/website/src/public/docs/faq/browse/extensions/unknown-sources-A7.light.webm
similarity index 100%
rename from website/src/public/docs/faq/extensions/unknown-sources-A7.light.webm
rename to website/src/public/docs/faq/browse/extensions/unknown-sources-A7.light.webm