onedrive full

docs/remote_services/onedrive/README.md

@@ -1,7 +1,7 @@
-# OneDrive
+# OneDrive (App Folder)
 
 - **This plugin is NOT an official Microsoft / OneDrive product.** The plugin just uses Microsoft's [OneDrive's public API](https://docs.microsoft.com/en-us/onedrive/developer/rest-api).
-- After the authorization, the plugin can read your name and email, and read and write files in your OneDrive's `/Apps/remotely-save` folder.
+- After the authorization, the plugin can read your name and email, and read and write files in your OneDrive's `/Apps/remotely-save` folder.**The free version of Remotely Save only connects to App Folder, while the PRO version can connect to the root folder in Onedrive.** 
 - If you decide to authorize this plugin to connect to OneDrive, please go to plugin's settings, and choose OneDrive then follow the instructions.
 - Password-based end-to-end encryption is also supported. But please be aware that **the vault name itself is not encrypted**.
 - If you want to sync the files across multiple devices, **your vault name should be the same** while using default settings.
@@ -21,3 +21,11 @@ The solution is simple:
 1. Backup your vault manually.
 2. Go to onedrive website (<https://onedrive.live.com/>), and rename `/Application/Graph` to `/Application/remotely-save` (right click on the folder and you will see rename option)
 3. Come back to Obsidian and try to sync!
+
+### Empty file is not uploaded
+
+Onedrive's API does not allow uploading empty files. You can choose to skip them or raise errors in Remotely Save plugin's settings.
+
+### How to connect to root folder rather than the App Folder?
+
+As of June 2024, this is a new PRO feature. See the [doc](../onedrivefull/README.md).

docs/remote_services/onedrivefull/README.md

@@ -0,0 +1,42 @@
+# Onedrive (Full) (PRO)
+
+# Intro
+
+* It's a PRO feature of Remotely Save plugin.
+* **This plugin is NOT an official Microsoft / Onedrive product, and just uses Onedrive's public api.**
+* This still only applies to Onedrive for personal. The dev team doesn't have Onedrive for business account to develop and test on it.
+
+# Steps
+
+## Steps of Remotely Save subscription
+
+1. Please sign up and sign in an online account, connect your plugin to your online account firstly. See [the PRO tutorial](../../pro/README.md) firstly.
+2. Subscribe to "sync with Onedrive (Full)" feature online.
+3. Go back to your Remotely Save plugin inside Obsidian, click "Check again" button in PRO settings. So that the plugin knows some features are enabled. In this case, sync with Onedrive (Full) should be detected.
+
+## Steps of Connecting to your Onedrive
+
+After you enabled the PRO feature in your Remotely Save plugin, you can connect to your Onedrive account now.
+
+1. In Remotely Save settings, change your sync service to Onedrive (Full).
+2. Click Auth, visit the link, go to Onedrive website to start.
+3. Follow the instruction on Onedrive, and allow Remotely Save to connect.
+4. You will be redirected back to Remotely Save plugin.
+5. A notice will tell you that you've connected or not.
+6. Sync! The plugin will create a vault folder **in the root** of your Onedrive and upload notes into that folder.
+7. **Read the caveats below.**
+
+# The caveats
+
+* As of June 2024, this feature is in beta stage. 
+    * **Back up your vault before using this feature.**
+    * **Back up everything in your Onedrive (besides the sync sub folder) before using this feature!**
+* Onedrive's API does not allow uploading empty files. You can choose to skip them or raise errors in Remotely Save plugin's settings.
+
+# What's the difference of Onedrive (App Folder) and Onedrive (Full)?
+
+Due to history reasons, Remotely Save only supported uploading to App Folder back to year 2021. Because that greatly ensured the security and ensure not messing up with others files.
+
+However, repeatedly some users want to sync to arbitrary root folder rather than `/Apps/remotely-save/` folder. Thus as of June 2024, the new PRO feature is finally developed.
+
+As of June 2024, connecting to Onedrive (App Folder) is free, but connecting to Onedrive (Full) is a PRO feature.