Import migration guides from website

Needed tweaking to handle Gatsby => Vitepress

docs/docs/.vitepress/sidebar.ts

@@ -6,6 +6,37 @@ export const sidebar = [
         text: "Photos",
         items: [
             { text: "Introduction", link: "/photos/" },
+            {
+                text: "Migration",
+                collapsed: true,
+                items: [
+                    {
+                        text: "Introduction",
+                        link: "/photos/migration/",
+                    },
+
+                    {
+                        text: "From Google Photos",
+                        link: "/photos/migration/from-google-photos/",
+                    },
+                    {
+                        text: "From Apple Photos",
+                        link: "/photos/migration/from-apple-photos/",
+                    },
+                    {
+                        text: "From Amazon Photos",
+                        link: "/photos/migration/from-amazon-photos",
+                    },
+                    {
+                        text: "From your hard disk",
+                        link: "/photos/migration/from-local-hard-disk",
+                    },
+                    {
+                        text: "Exporting your data",
+                        link: "/photos/migration/export/",
+                    },
+                ],
+            },
             {
                 text: "Features",
                 collapsed: true,
@@ -68,7 +99,7 @@ export const sidebar = [
             { text: "Introduction", link: "/auth/" },
             { text: "FAQ", link: "/auth/faq/" },
             {
-                text: "Migration guides",
+                text: "Migration",
                 collapsed: false,
                 items: [
                     { text: "Introduction", link: "/auth/migration-guides/" },

docs/docs/photos/migration/export/index.md

@@ -0,0 +1,36 @@
+---
+title: Exporting your data from Ente Photos
+description: Guide for exporting your photos out from Ente Photos
+---
+
+# Exporting your data out of Ente Photos
+
+Please follow the following simple steps to keep a local copy of the photos and
+videos you have uploaded to Ente.
+
+1. Sign in to [our desktop app](https://ente.io/download/desktop), if you
+   haven't done so already.
+
+2. Open the side bar, and select the option to **export data**.
+
+    ![Ente - Export data](export-1.png)
+
+3. Select the destination folder and click on **start**.
+
+    ![Ente - Select destination folder and start](export-2.png)
+
+4. Wait for the export to get completed.
+
+    ![Ente - Export in progress](export-3.png)
+
+5. Later on if you wish to sync newer files that were uploaded since the last
+   time you exported, simply select **export data** again and click on
+   **resync**.
+
+    ![Ente - Rexport](export-4.png)
+
+In case your download gets interrupted, Ente will resume from where it left off.
+Simply select **export data** again and click on **resync**.
+
+If you run into any issues during your data export, please reach out to
+[support@ente.io](mailto:support@ente.io) and we will be happy to help you!

docs/docs/photos/migration/from-amazon-photos.md

@@ -0,0 +1,23 @@
+---
+title: Import from Amazon Photos
+description: Migrating your existing photos from Amazon Photos to Ente Photos
+---
+
+# Import from Amazon Photos
+
+Amazon Photos does not provide a way to export all of your photos and videos, or
+even albums with a single click.
+
+According to their [help desk
+article](https://www.amazon.com/gp/help/customer/display.html?nodeId=GVCELKY5JW77VE7W),
+you have to select and download photos individually.
+
+Once you've done that, simply drag and drop this folder into [our desktop
+app](https://ente.io/download/desktop), and Ente will take care of the rest.
+
+> Note: In case your uploads get interrupted, just drag and drop the folder into
+> the same album again, and we will ignore already backed up files and upload
+> just the rest.
+
+If you run into any issues during this migration, please reach out to
+[support@ente.io](mailto:support@ente.io) and we will be happy to help you!

docs/docs/photos/migration/from-apple-photos/index.md

@@ -0,0 +1,33 @@
+---
+title: Import from Apple Photos
+description: Migrating your existing photos from Apple Photos to Ente Photos
+---
+
+# Import from Apple Photos
+
+The Apple Photos app provides an easy way download all your data.
+
+Select the files you want to export (`Command + A` to select them all), and
+click on `File` > `Export` > `Export Unmodified Originals`.
+
+![Apple Photos - Export](export.png)
+
+In the dialog that pops up, select File Name as `Sequential` and provide any
+prefix you'd like. This is to make sure that we combine the photo and video
+portions of your Live Photos correctly.
+
+![Apple Photos - Sequential file names](sequential.png)
+
+Finally, choose an export directory and confirm by clicking `Export Originals`.
+You will receive a notification from the app once your export is complete.
+
+Now simply drag and drop the downloaded folders into [our desktop
+app](https://ente.io/download/desktop) and grab a cup of coffee (or a good
+night's sleep, depending on the size of your library) while we handle the rest.
+
+> Note: In case your uploads get interrupted, just drag and drop the folders
+> into the same albums again, and we will ignore already backed up files and
+> upload just the rest.
+
+If you run into any issues during this migration, please reach out to
+[support@ente.io](mailto:support@ente.io) and we will be happy to help you!

docs/docs/photos/migration/from-google-photos/index.md

@@ -0,0 +1,62 @@
+---
+title: Import from Google Photos
+description: Migrating your existing photos from Google Photos to Ente Photos
+---
+
+# Import from Google Photos
+
+Follow the following steps to recover your data from Google Photos and preserve
+it with Ente.
+
+### Steps
+
+1. Open [takeout.google.com](https://takeout.google.com).
+
+2. Click on "Deselect All" (since by default all Google services are selected).
+
+    ![Google Takeout - Create a new export](google-photos-1.png)
+
+3. Scroll down to find Google Photos in the list and select it by clicking the
+   check box next to it.
+
+    ![Google Takeout - Select Google Photos](google-photos-2.png)
+
+4. Click on the button that says "All photo albums included".
+
+5. Select the albums you want to export.
+
+    ![Google Takeout - Select albums](google-photos-3.png)
+
+6. Scroll down and click on "Next Step".
+
+    ![Google Takeout - Next](google-photos-4.png)
+
+7. Select "Frequency" and "File size" depending on the amount of storage on your
+   system and click on "Create export". Make sure you select ZIP as the format.
+
+    ![Google Takeout - Frequency and file size](google-photos-5.png)
+
+8. Wait for Google to send you your data.
+
+9. Open [our desktop app](https://ente.io/download/desktop), click on "Upload",
+   select "Google takeout" and pick the ZIP file you just downloaded.
+
+    ![Importing Google Takeout into Ente](google-takeout.png){width=400px}
+
+10. Wait for the uploads to complete as Ente parses the metadata generated by
+    Google, and preserves them along with the corresponding files, end-to-end
+    encrypted!
+
+---
+
+In case your uploads get interrupted, just drag and drop the file again and we
+will ignore already backed up files and upload just the rest.
+
+If you run into any issues during this migration, please reach out to
+[support@ente.io](mailto:support@ente.io) and we will be happy to help you!
+
+> Note: When importing a Google takeout, Ente will parse the metadata in the
+> JSON files and stich them together with corresponding files. However, one case
+> this will not work is when Google has split the export into multiple parts,
+> and did not put the JSON file associated with an image in the same exported
+> zip.

docs/docs/photos/migration/from-local-hard-disk.md

@@ -0,0 +1,18 @@
+---
+title: Import from local hard disk
+description: Migrating to Ente Photos by importing data from your local hard disk
+---
+
+# Import photos from your local hard disk
+
+Simply drag and drop the folders you want to preserve into [our desktop
+app](https://ente.io/download/desktop) and grab a cup of coffee (or a good
+night's sleep depending on the size of your library), while we will take care of
+the rest.
+
+> Note: in case your uploads get interrupted, just drag and drop the folders
+> into the same albums again, and we will ignore already backed up files and
+> upload just the rest.
+
+If you run into any issues during uploads, please reach out to
+[support@ente.io](mailto:support@ente.io) and we will be happy to help you!

docs/docs/photos/migration/index.md

@@ -0,0 +1,13 @@
+---
+title: Migrating
+description:
+    Guides for migrating your existing photos into Ente Photos and exporting your data out of Ente Photos
+---
+
+# Migrating to/from Ente Photos
+
+-   [Import from Google Photos](from-google-photos/)
+-   [Import from Apple Photos](from-apple-photos/)
+-   [Import from Apple Photos](from-amazon-photos)
+-   [Import from Apple Photos](from-local-hard-disk)
+-   [Export your data out of Ente Photos](export)