Add Storage location tip & adjust wording (#130)

* Included "section" in the embed (now "this section") for visibility * Add storage location tip * Added storage location tip * Replaced index setting mention with current setting name
mihonapp · Jan 10, 2025 · e5925c7 · e5925c7
1 parent 9d859e1
commit e5925c7
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 2 deletions.
diff --git a/website/src/docs/faq/storage.md b/website/src/docs/faq/storage.md
@@ -8,6 +8,13 @@ description: Understanding Storage Permissions.
 
 Mihon manages several things within a selected storage location, including automatic backups, chapter downloads, and the Local source.
 
+::: tip Selecting a storage location
+Keep the following in mind when setting up your Storage location:
+* Create a "Mihon" folder at the top-level of your storage (ex. `/Internal Storage/Mihon/`).
+* **Do not** use your device's "Documents" or "Downloads" folder as your storage location, system folders restrict & cause issues when Mihon tries to access them.
+* When selecting your storage location during the setup process, give access to the "Mihon" folder, not the folders within.
+:::
+
 The following illustrates the folder structure:
 
 :::info Example
@@ -111,7 +118,7 @@ If you have an existing `downloads` folder, you should be selecting its parent f
 Note the illustrated example above where `downloads` is a folder _within_ the location being set, and the individual source folders are _within_ that `downloads` folder.
 :::
 
-If you need to change your storage location or have moved files around from outside the app, you may need to force the app to recheck for the files by going to <nav to="advanced"> then **Invalidate downloads index**.
+If you need to change your storage location or have moved files around from outside the app, you may need to force the app to recheck for the files by going to <nav to="advanced"> then **Reindex downloads**.
 
 # Scoped Storage
 

diff --git a/website/src/docs/guides/troubleshooting/common-issues.md b/website/src/docs/guides/troubleshooting/common-issues.md
@@ -18,7 +18,7 @@ Here's how to tackle common challenges.
 * Else, delete **Mihon** downloads folder on SD card.
 
 ### Storage issues with Android 11+
-See [this](/docs/faq/storage) section of the FAQ to learn how Scoped Storage affects **Mihon** in **Android 11+** and how to fix it.
+See [this section](/docs/faq/storage) of the FAQ to learn how Scoped Storage affects **Mihon** 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.