[docs] import FAQs and other docs from website (#1167)

- Documentation only change.
- Verified visually, and that `yarn build` runs.

docs/docs/.vitepress/sidebar.ts

@@ -12,15 +12,32 @@ export const sidebar = [
                 items: [
                     { text: "Albums", link: "/photos/features/albums" },
                     { text: "Archiving", link: "/photos/features/archive" },
+                    {
+                        text: "Background sync",
+                        link: "/photos/features/background",
+                    },
+                    { text: "Backup", link: "/photos/features/backup" },
                     { text: "Cast", link: "/photos/features/cast/" },
+                    {
+                        text: "Collaboration",
+                        link: "/photos/features/collaborate",
+                    },
                     {
                         text: "Collecting photos",
                         link: "/photos/features/collect",
                     },
+                    {
+                        text: "Deduplicate",
+                        link: "/photos/features/deduplicate",
+                    },
                     {
                         text: "Family plans",
                         link: "/photos/features/family-plans",
                     },
+                    {
+                        text: "Free up space",
+                        link: "/photos/features/free-up-space/",
+                    },
                     { text: "Hidden photos", link: "/photos/features/hide" },
                     {
                         text: "Location tags",
@@ -32,20 +49,72 @@ export const sidebar = [
                         link: "/photos/features/public-link",
                     },
                     { text: "Quick link", link: "/photos/features/quick-link" },
-                    { text: "Referrals", link: "/photos/features/referrals" },
-                    { text: "Sharing", link: "/photos/features/sharing" },
+                    {
+                        text: "Referral program",
+                        link: "/photos/features/referral-program/",
+                    },
+                    { text: "Sharing", link: "/photos/features/share" },
                     { text: "Trash", link: "/photos/features/trash" },
                     {
                         text: "Uncategorized",
                         link: "/photos/features/uncategorized",
                     },
                     {
-                        text: "Watch folder",
-                        link: "/photos/features/watch-folder",
+                        text: "Watch folders",
+                        link: "/photos/features/watch-folders",
+                    },
+                ],
+            },
+            {
+                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: "FAQ",
+                collapsed: true,
+                items: [
+                    { text: "General", link: "/photos/faq/general" },
+                    {
+                        text: "Security and privacy",
+                        link: "/photos/faq/security-and-privacy",
+                    },
+                    {
+                        text: "Subscription and plans",
+                        link: "/photos/faq/subscription",
+                    },
+                    {
+                        text: "Hide vs archive",
+                        link: "/photos/faq/hidden-and-archive",
                     },
                 ],
             },
-            { text: "FAQ", link: "/photos/faq/" },
             {
                 text: "Troubleshooting",
                 collapsed: true,
@@ -68,7 +137,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/" },
@@ -185,7 +254,7 @@ function sidebarOld() {
                         },
                         {
                             text: "Watch folder",
-                            link: "/photos/features/watch-folder",
+                            link: "/photos/features/watch-folders",
                         },
                         { text: "Trash", link: "/photos/features/trash" },
                         {

docs/docs/auth/migration-guides/authy/index.md

@@ -94,11 +94,11 @@ to ente Authenticator!
 ### Method 2.1: If the export worked, but the import didn't
 
 > [!NOTE]
-> 
-> This is intended only for users who successfully exported their codes using the
-> guide in method 2, but could not import it to ente Authenticator for whatever
-> reason. If the import was successful, or you haven't tried to import the codes
-> yet, ignore this section.
+>
+> This is intended only for users who successfully exported their codes using
+> the guide in method 2, but could not import it to ente Authenticator for
+> whatever reason. If the import was successful, or you haven't tried to import
+> the codes yet, ignore this section.
 >
 > If the export itself failed, try using
 > [**method 1**](#method-1-use-neerajs-export-tool) instead.

docs/docs/photos/faq/general.md

@@ -0,0 +1,76 @@
+---
+title: General FAQ
+description: An assortment of frequently asked questions about Ente Photos
+---
+
+# General FAQ
+
+## How can I earn free storage?
+
+Use our [referral program](/photos/features/referral-program/).
+
+## What file formats does Ente support?
+
+Ente supports all files that have a mime type of `image/*` or `video/*`
+regardless of their specific format.
+
+However, we only have limited support for RAW currently. We are working towards
+adding full support, and you can watch this
+[thread](https://github.com/ente-io/ente/discussions/625) for updates.
+
+If you find an issue with ente's ability to parse a certain file type, please
+write to [support@ente.io](mailto:support@ente.io) with details of the
+unsupported file format and we will do our best to help you out.
+
+## Is there a file size limit?
+
+Yes, we currently do not support files larger than 4 GB.
+
+If this constraint is a concern for you, please write to
+[support@ente.io](mailto:support@ente.io) with your use case and we will do our
+best to help you.
+
+## Does Ente support videos?
+
+Ente supports backing up and downloading of videos in their original format and
+quality.
+
+But some of these formats cannot be streamed on the web browser and you will be
+prompted to download them.
+
+## Why does Ente consume lesser storage than other providers?
+
+Most storage providers compute your storage quota in GigaBytes (GBs) by dividing
+your total bytes uploaded by `1000 x 1000 x 1000`.
+
+Ente on the other hand, computes your storage quota in GibiBytes (GiBs) by
+dividing your total bytes uploaded by `1024 x 1024 x 1024`.
+
+We decided to leave out the **i** from **GiBs** to reduce noise on our
+interfaces.
+
+## Why should I trust Ente for long-term data-storage?
+
+Unlike large companies, we have a focused mission, to build a safe space where
+you can easily archive your personal memories.
+
+This is the only thing we want to do, and with our pricing model, we can
+profitably do it.
+
+We preserve your data end-to-end encrypted, and our open source apps have been
+[externally audited](https://ente.io/blog/cryptography-audit/).
+
+Also, we have spent great deal of engineering effort into designing reliable
+data replication and graceful disaster recovery plans. This is also done
+transparently - we have documented the specifics of our replication and
+reliability [here](https://ente.io/reliability).
+
+In short, we love what we do, we have no reasons to be distracted, and we are as
+reliable as any one can be.
+
+If you would like to fund the development of this project, please consider
+[subscribing](https://ente.io/download).
+
+## How do I pronounce ente?
+
+It's like cafe 😊. kaf-_ay_. en-_tay_.

docs/docs/photos/faq/hidden-and-archive.md

@@ -0,0 +1,36 @@
+---
+title: Can I hide photos in ente?
+description: Two related ways of hiding or archiving in Ente Photos
+---
+
+# Can I hide photos in ente?
+
+Yes, you can hide specific photos and videos in Ente using the "Hide" action.
+Open the photo, expand the overflow menu and select Hide (the action with the
+eye icon).
+
+Hidden items do not appear anywhere in Ente except within the special "Hidden"
+category. Ente will ask for the device biometric (FaceID / TouchID) or passcode
+to view the contents of the Hidden category.
+
+You can reach the Hidden category from the bottom of the albums screen.
+
+Keep in mind that hidden items will still show up in the "On device" albums
+within Ente as long as they are present in your native gallery. But once you
+remove them from your device, they'll stop showing up here.
+
+Hiding is currently only supported in the Ente mobile app, and items hidden from
+the mobile app will not be visible in the web and desktop app.
+
+For more details, see [features/hide](/photos/features/hide).
+
+### Archive
+
+There is also a related feature called "Archive". While hidden items do not
+appear anywhere, archived items do not appear in your timeline but can otherwise
+be seen within the album and search results.
+
+This is useful when you're not trying to hide certain photos per se, but just do
+not want some of them (say, some old screenshots) to clutter your home timeline.
+
+For more details, see [features/archive](/photos/features/archive).

docs/docs/photos/faq/index.md

@@ -1,9 +0,0 @@
----
-title: FAQ
-description: Frequently asked questions about Ente Photos
----
-
-# FAQ
-
-_Coming soon_. On this page we'll document some help items in a question and
-answer format.

docs/docs/photos/faq/security-and-privacy.md

@@ -0,0 +1,82 @@
+---
+title: Security and privacy FAQ
+description:
+    Frequently asked questions about security and privacy of Ente Photos
+---
+
+# Security and privacy
+
+## Can Ente see my photos and videos?
+
+No.
+
+Your files are encrypted with a key before they are uploaded to our servers.
+
+These keys can be accessed only with your password.
+
+Since only you know your password, only you can decrypt your files.
+
+To learn more about our encryption protocol, please read about our
+[architecture](https://ente.io/architecture).
+
+## How is my data encrypted?
+
+We use [libsodium](https://libsodium.gitbook.io/doc/)'s implementations
+`XChaCha20` and `XSalsa20` to encrypt your data, along with `Poly1305` MAC for
+authentication.
+
+Please refer to the document on our [architecture](https://ente.io/architecture)
+for more details.
+
+## Where is my data stored?
+
+Your data is replicated to multiple providers in different countries in the EU.
+
+Currently we have datacenters in the following locations:
+
+-   Amsterdam, Netherlands
+-   Paris, France
+-   Frankfurt, Germany
+
+Much more details about our replication and reliability are documented
+[here](https://ente.io/reliability).
+
+## What happens if I forget my password?
+
+You can reset your password with your recovery key.
+
+If you lose both your password and your recovery key, you will not be able to
+decrypt your data.
+
+## Can I change my password?
+
+Yes.
+
+You can change your password from any of our apps.
+
+Thanks to our [architecture](https://ente.io/architecture), you can do so
+without having to re-encrypt any of your files.
+
+The privacy of your account is a function of the strength of your password,
+please choose a strong one.
+
+## Do you support 2FA?
+
+Yes.
+
+You can setup two-factor authentication from the settings screen of the mobile
+app or from the side bar of our desktop app.
+
+## How does sharing work?
+
+The information required to decrypt an album is encrypted with the recipient's
+public key such that only they can decrypt them.
+
+You can read more about this [here](https://ente.io/architecture#sharing).
+
+In case of sharable links, the key to decrypt the album is appended by the
+client as a [fragment to the URL](https://en.wikipedia.org/wiki/URI_fragment),
+and is never sent to our servers.
+
+Please note that only users on the paid plan are allowed to share albums. The
+receiver just needs a free Ente account.

docs/docs/photos/faq/subscription.md

@@ -0,0 +1,158 @@
+---
+title: Subscription FAQ
+description: Frequently asked questions about Ente Photos subscription and plans
+---
+
+# Subscription and plans
+
+See our [website](https://ente.io#pricing) for the list of supported plans and
+pricing.
+
+## Does Ente have Family Plans?
+
+Yes we do! Please check out our announcement post
+[here](https://ente.io/blog/family-plans).
+
+In brief,
+
+-   Your family members can use storage space from your plan without paying
+    extra.
+
+-   Ask them to sign up for Ente, and then just add them to your existing plan
+    using the "Manage family" option within your Subscription settings.
+
+-   Each member gets their own private space, and cannot see each other's files
+    unless they're shared.
+
+-   You can invite 5 family members. So including yourself, it will be 6 people
+    who can share a single subscription, paying only once.
+
+Note that family plans are meant as a way to share storage. For sharing photos,
+you can create [shared albums and links](/photos/features/share).
+
+## Does Ente offer discounts to students?
+
+Yes we do!
+
+We believe that privacy should be made accessible to everyone. In this spirit,
+we offer **30% off** our subscription plans to students.
+
+To apply for this discount, please verify your enrollment status in a school /
+college / university by writing to [students@ente.io](mailto:students@ente.io)
+from the email address assigned to you by your institute.
+
+In case you do not have access to such an email address, please send us proof
+(such as your institute's identity card) that verifies your identity as a
+student.
+
+Please note that these discounts are valid for a year, after which you may
+reapply to reclaim the discount.
+
+## What payment methods does Ente support?
+
+On Web, Desktop and Android, Stripe helps us process payments from all major
+prepaid and credit card providers.
+
+On iOS, we (have to) use the billing platforms provided by the app store.
+
+Apart from these, we also support PayPal and crypto currencies (more details
+below).
+
+## Can I pay with PayPal?
+
+We support **annual** subscriptions over PayPal.
+
+Please drop an email to paypal@ente.io from your registered email address,
+mentioning the [storage plan](https://ente.io#pricing) of your choice and we
+will send you an invoice with a link to complete the payment.
+
+Once the payment is completed, your account will be upgraded to the chosen plan.
+
+## Does Ente accept crypto payments?
+
+We accept the following crypto currencies:
+
+-   Bitcoin
+-   Ethereum
+-   Dogecoin
+
+To purchase a subscription with any of the above mentioned currencies, please
+write to crypto@ente.io from your registered email address, citing the
+[storage plan](https://ente.io#pricing) of your choice.
+
+In case you have any further questions or need support, please reach out to
+[support@ente.io](mailto:support@ente.io), and we'll be happy to help!
+
+> Please note that Ente does not provide anonymity. What we provide is privacy,
+> since your data is end-to-end encrypted.
+> [Information](https://ente.io/privacy/#3-what-information-do-we-collect) we
+> have about you might make your identity deducible. We are accepting crypto as
+> a way to make Ente more accessible, not to provide anonymity.
+
+## Does Ente store my card details?
+
+Ente does not store any of your sensitive payment related information.
+
+We use [Stripe](https://stripe.com) to handle our card payments, and all of your
+payment information is sent directly to Stripe's PCI DSS validated servers.
+
+Stripe has been audited by a PCI-certified auditor and is certified to
+[PCI Service Provider Level 1](https://www.visa.com/splisting/searchGrsp.do?companyNameCriteria=stripe).
+This is the most stringent level of certification available in the payments
+industry.
+
+All of this said, if you would still like to pay without sharing your card
+details, you can pay using PayPal.
+
+## What happens if I exceed my storage limit?
+
+Ente will stop backing up your files and you will receive an email alerting you
+of the same.
+
+Your backed up files will remain accessible for as long as you have an active
+subscription.
+
+## What happens when my subscription expires?
+
+30 days after your subscription expires, all of your uploaded data will be
+cleared from our servers.
+
+You will receive an email prompting you to take out all of your backed up data
+before this happens.
+
+## What happens when I upgrade my plan?
+
+Your new plan will go into effect immediately, and you only have to pay the
+difference. We will adjust your remaining pro-rated balance on the old plan when
+invoicing you for the new plan.
+
+For example, if you are half way through the year on the 100 GB yearly plan, and
+upgrade to the 500 GB yearly plan, then
+
+-   The new 500 GB yearly plan will go into effect immediately.
+
+-   But we will reduce the charges for the first year by subtracting the
+    remaining half year balance of the 100 GB yearly plan that you'd already
+    paid.
+
+The same applies to monthly plans.
+
+## Is there an x GB plan?
+
+We have experimented quite a bit and have found it hard to design a single
+structure that fits all needs. Some customers wish for many options, some even
+wish to go to an extreme of dynamic per GB pricing. Other customers wish to keep
+everything simple, some even wish for a single unlimited plan.
+
+To keep things fair, our plans don't increase linearly, and the tiers are such
+that cover the most requested patterns.
+
+In addition, we also offer [family plans](/photos/features/family-plans) so that
+you can gain more value out of a single subscription.
+
+## Is there a forever-free plan?
+
+Sorry, since we're building a business that does not involve monetization of
+user data, we have to charge to remain sustainable.
+
+We do offer a generous free trial for you to experience the product.

docs/docs/photos/features/background.md

@@ -0,0 +1,57 @@
+---
+title: Background sync
+description: Ente Photos supports automatic background sync and backup
+---
+
+# Background sync
+
+Ente Photos supports seamless background sync so that you don't need to open the
+app to backup your photos. It will sync in the background and automatically
+backup the albums that you have selected for syncing.
+
+Day to day sync will work automatically. However, there are some platform
+specific considerations that apply, more on these below:
+
+### iOS
+
+On iOS, if you have a very large number of photos and videos, then you might
+need to keep Ente running in the foreground for the first backup to happen
+(since we get only a limited amount of background execution time). To help with
+this, under "Settings > Backup" there is an option to disable the automatic
+device screen lock. But once your initial backup has completed, subsequent
+backups will work fine in the background and don't need disabling the screen
+lock.
+
+On iOS, Ente will not backup videos in the background (since videos are usually
+much larger and need more time to upload than what we get). However, they will
+get backed up the next time the Ente app is opened.
+
+Note that the Ente app will not be able to backup in the background if you force
+kill the app.
+
+> If you're curious, the way this works is, our servers "tickle" your device
+> every once in a while by sending a silent push notification, which wakes up
+> our app and gives it 30 seconds to execute a background sync. However, if you
+> have killed the app from recents, iOS will not deliver the push to the app,
+> breaking the background sync.
+
+### Android
+
+On some Android versions, newly downloaded apps activate a mode called "Optimize
+battery usage" which prevents them from running in the background. So you will
+need to disable this "Optimize battery usage" mode in the system settings for
+Ente if you wish for Ente to automatically back up your photos in the
+background.
+
+### Desktop
+
+In addition to our mobile apps, the background sync also works on our desktop
+app, though the [way that works](watch-folders) is a bit different.
+
+---
+
+## Troubleshooting
+
+-   On iOS, make sure that you're not killing the Ente app.
+-   On Android, make sure that "Optimize battery usage" is not turned on in
+    system settings for the Ente app.

docs/docs/photos/features/backup.md

@@ -0,0 +1,22 @@
+---
+title: Backup
+description: Details about how backup works in Ente Photos
+---
+
+# Backup
+
+Ente will automatically backup any albums in your native photos app that you
+select for backup.
+
+Ente will run in the background, and any new photos added to these albums (or
+any photos in these albums that were modified) will be automatically synced to
+ente.
+
+You can choose which albums should be backed up when you sign up for Ente. If
+you change your mind later, or if you create a new album in your native photos
+app that you also want to backup, please use "Settings > Backup > Backed up
+folders" to modify your choices.
+
+If a file is deleted on your native photos app, it will still show up in Ente.
+This is because on both iOS and Android, apps are not allowed to automatically
+delete user's photos without a manual confirmation.

docs/docs/photos/features/collaborate.md

@@ -0,0 +1,63 @@
+---
+title: Collaboration
+description: Collaborate with other people using shared albums and public links
+---
+
+# Collaborate
+
+Ente allows you to collaborate with people in 2 ways:
+
+-   Collaborative albums
+
+-   Collaborative links
+
+## Collaborative albums
+
+Collaborative albums allow multiple Ente users to add photos to the same shared
+album. Storage is only counted once, irrespective of the number of collaborators
+and viewers.
+
+-   The owner of the album is the person who created it.
+
+-   The owner can add collaborators and viewers by their email. The owner can
+    also change permissions of participants at any time, and remove them.
+
+-   Collaborators can add photos (and videos) to the shared album.
+
+-   The storage of the photo is counted towards the owner of the photo - the
+    person who uploaded it. Since the uploader usually has the photo in their
+    account anyway, effectively this means that the photo can be added to a
+    collaborative album without paying anything extra.
+
+-   The owner of the photo can remove it from the album (or delete it).
+
+-   The owner of the album can remove all photos from the album (they can only
+    delete the photos they own).
+
+-   When a collaborator is removed from a shared album (or when they leave the
+    album), any photos they'd uploaded will also be removed.
+
+Currently collaborative albums can only be used from the mobile app. A
+collaborator will see them in view only mode in the web and desktop apps; we're
+actively working on adding support for them on web and desktop too.
+
+## Collaborative links
+
+Collaborative links allow you to collaborate with people who might not have an
+Ente account or the Ente apps.
+
+-   You can create a public link, and anyone with access to the link will be
+    able to view the shared photos using just their web browser (no login
+    required).
+
+-   You can enable the "Allow adding photos" option on a public link to allow
+    people to also add photos the same way (from their web browser, no login
+    required).
+
+Such collaborative links are also sometimes called "collect links", since they
+allow you to collect photos from people without them needing Ente accounts. A
+common use case for this is collecting event and trip photos from a big circle
+of people.
+
+The storage for the photos added to a collaborative link are counted towards the
+album owner. The owner can also remove these photos at any time.

docs/docs/photos/features/deduplicate.md

@@ -0,0 +1,59 @@
+---
+title: Deduplicate
+description: Removing duplicates photos using Ente Photos
+---
+
+# Deduplicate
+
+Ente performs two different duplicate detections: one during uploads, and one
+that can be manually run afterwards to remove duplicates across albums.
+
+## During uploads
+
+Ente will automatically deduplicate and ignore duplicate files during uploads.
+
+When uploading, Ente will ignore exact duplicate files. This allows you to
+resume interrupted uploads, or drag and drop the same folder, or reinstall the
+app, and expect Ente to automatically skip duplicates and only add new files.
+
+The duplicate detection works slightly different on each platform, to cater to
+the platform's nuances.
+
+#### Mobile
+
+-   On iOS, a hash will be used to detect exact duplicates. If the duplicate is
+    being uploaded to an album where a photo with the same hash already exists,
+    then the duplicate will be skipped. If it is being uploaded to a different
+    album, then a symlink will be created (so no actual data will need to be
+    uploaded, just a symlink will be created to the existing file).
+
+-   On Android also, a hash check is used. But unlike iOS, the native Android
+    filesystem behaviour is to keep physical copies if the same photo is in
+    different albums. So Ente does the same: duplicates to same album will be
+    skipped, duplicates when going to separate albums will create copies.
+
+#### Web and desktop
+
+On laptops (i.e. when using the Ente web or desktop app), in addition to a hash
+check, the file name is also used. The assumption is that the user wishes to
+keep two copies if they have the same file but with different names.
+
+Thus a file will be considered a duplicate and skipped during upload if a file
+with the same name and hash already exists in the album.
+
+And if you're trying to upload it to a different album (i.e. the same file with
+the same name already exists in a different album), then a symlink to the
+existing file will be created. This is similar to what happens when you do "Add
+to album", and the actual files are not re-uploaded.
+
+## Manual deduplication
+
+Ente also provides a tool for manual de-duplication in _Settings → Backup →
+Remove duplicates_. This is useful if you have an existing library with
+duplicates across different albums, but wish to keep only one copy.
+
+## Adding to Ente album creates symlinks
+
+Note that once a file in is Ente, adding it to another Ente album will create a
+symlink, so that you can add it to as many albums as you wish but storage will
+only be counted once.

docs/docs/photos/features/family-plans.md

@@ -23,9 +23,12 @@ In brief,
 -   You can invite 5 family members. So including yourself, it will be 6 people
     who can share a single subscription, paying only once.
 
-
 ## FAQ
 
-* **Can you assign a storage quota for each individual member in the family plan?**   
-   Unfortunately, at this moment, assigning a storage quota for each individual member in the family plan is not supported. For updates on this feature request, please follow  [this thread](https://github.com/ente-io/ente/discussions/857).
- 
+-   **Can you assign a storage quota for each individual member in the family
+    plan?**
+
+    Unfortunately, at this moment, assigning a storage quota for each individual
+    member in the family plan is not supported. For updates on this feature
+    request, please follow
+    [this thread](https://github.com/ente-io/ente/discussions/857).

docs/docs/photos/features/free-up-space/index.md

@@ -0,0 +1,18 @@
+---
+title: Free up space
+description: Freeing up your phone's storage space when using Ente Photos
+---
+
+# Free up your phone's storage space
+
+Within the app's settings page, you have an option to free up space by deleting
+all backed up photos and videos from your phone's internal storage.
+
+<div align="center">
+
+![Free up space screen](free-up-space.png){width=400px}
+
+</div>
+
+> Note: You might have to clear the device's trash to realize this cleared
+> space.

docs/docs/photos/features/referral-program/index.md

@@ -0,0 +1,65 @@
+---
+title: Referral program
+description: Earn free storage by referring Ente Photos to your friends
+---
+
+# Referral program
+
+You can refer your friends to earn free storage on Ente.
+
+For each friend you refer, who upgrades to a paid plan, we will credit **10 GB**
+of free storage. The referred customer will also receive an additional **10 GB**
+with their paid subscription.
+
+That is, if you refer a friend, once your friend upgrades to a paid plan, both
+you and your friend receive an additional 10 GB of storage.
+
+You can find your referral code under _Settings → General → Referrals_.
+
+<div align="center">
+
+![Claim free storage screen](free-storage.png){width=400px}
+
+</div>
+
+### How much storage can I earn?
+
+The amount of free storage you can earn is capped to your current plan. This
+means, you can at max <u>double your storage</u>. For example, if you're on a
+100 GB plan, you can earn another 100 GB (by referring 10 friends), taking your
+total available storage to 200 GB.
+
+You can keep track of your earned storage and referral details on _Claim free
+storage_ screen.
+
+If you refer more paid customers than is allowed by your current plan, the extra
+storage earned will be reserved and will become usable once you upgrade your
+plan.
+
+### For how long do I have access to this storage?
+
+Earned storage will be accessible as long as your subscription is active,
+provided there has been no abuse.
+
+In case our systems detect abuse, we may notify you and take back credited
+storage. Low quality referrals (who don't renew their plans) or creation of fake
+accounts, etc. could result in this.
+
+### How can my friends apply my referral code?
+
+Referral codes can be applied within _Settings → General → Referrals → Apply
+Code_.
+
+<div align="center">
+
+![Apply referral code screen](referral-code-application.png){width=400px}
+
+</div>
+
+Please note that referral codes should be applied within one month of account
+creation to claim free storage.
+
+---
+
+More questions? Drop a mail to [referrals@ente.io](mailto:referrals@ente.io),
+and we'll get back to you!

docs/docs/photos/features/referrals.md

@@ -1,48 +0,0 @@
----
-title: Referral plan
-description:
-    Earn and expand your storage by referring Ente Photos to your friends and
-    family
----
-
-# Referral plan
-
-_Earn and Expand Your Storage_
-
-Did you know you can boost your storage on Ente simply by referring your
-friends? Our referral program lets you earn 10 GB of free storage for each
-friend who upgrades to a paid plan, and your referred friends receive an
-additional 10 GB with their subscription.
-
-## How to Refer a friend?
-
-On the Home Page:
-
--   Click on the hamburger menu in the top left corner
--   Open the sidebar
--   Tap on _General_
--   Select _Referrals_
--   Share the code with your friend or family
-
-Note:
-
--   Once your friend upgrades to a paid plan, both you and your friend receive
-    an additional 10 GB of storage.
--   You can keep track of your earned storage and referral details on _Claim
-    free storage_ screen.
--   If you refer more friends than your plan allows, the extra storage earned
-    will be reserved until you upgrade your plan.
--   Earned storage remains accessible as long as your subscription is active.
-
-## How to apply referral code given by a friend?
-
-On the Home Page:
-
--   Click on the hamburger menu inthe top left corner
--   Tap on _General_ from the options
--   Select _Referrals_ from the menu
--   Find and tap on _Apply Code_
--   Enter the referral code provided by your friend.
-
-Please note that referral codes should be applied within one month of account
-creation to claim the free storage.

docs/docs/photos/features/share.md

@@ -0,0 +1,75 @@
+---
+title: Share
+description: Securely share photos and videos stored in Ente Photos
+---
+
+# Sharing
+
+Ente supports end-to-end encrypted sharing of your photos and videos.
+
+This allows you to share your photos and videos with only the people you want,
+without them being visible to anybody else. The files remain encrypted at all
+times, and only the people you have shared with get the decryption keys.
+
+-   If the person you want to share with is already on Ente, you can share an
+    album with them by entering their email address.
+
+-   If they are not already on Ente, you can send them an invite and then share
+    with them after they've signed up.
+
+-   Alternatively, you can create public links to share albums with people who
+    are not on Ente.
+
+With public links, the files are still end-to-end encrypted, so the sharing is
+still secure. Note that the decryption keys are part of the public link so keep
+in mind that anybody with the link will be able to share it with others.
+
+Both shared albums and public links allow [collaboration](collaborate).
+
+## Links
+
+You can create links to your albums by opening an album and clicking on the
+Share icon. They are publicly accessible by anyone who you share the link with.
+They don't need an app or account.
+
+These links can be password protected, or set to expire after a while.
+
+You can read more about the features supported by Links
+[here](https://ente.io/blog/powerful-links/).
+
+## Albums
+
+If your loved ones are already on Ente, you can share an album with their
+registered email address.
+
+If they are your partner, you can share your `Camera` folder on Android, or
+`Recents` on iOS. Whenever you click new photos, they will automatically be
+accessible on your partner's device.
+
+## Collaboration
+
+You can allow other Ente users to add photos to your album. This is a great way
+for you to build an album together with someone. You can control access to the
+same album - someone can be added as a `Collaborator`, while someone else as a
+`Viewer`.
+
+If you wish to collect photos from folks who are not Ente, you can do so with
+our Links. Simply tick the box that says "Allow uploads", and anyone who has
+access to the link will be able to add photos to your album.
+
+## Technical details
+
+More details, including technical aspect about how the sharing features were
+implemented, are in various blog posts announcing these features.
+
+-   [Collaborative albums](https://ente.io/blog/collaborative-albums)
+
+-   [Collect photos from people not on ente](https://ente.io/blog/collect-photos)
+
+-   [Shareable links for albums](https://ente.io/blog/shareable-links),
+    [and their underlying technical implementation](https://ente.io/blog/building-shareable-links).
+    Since then, we have also added the ability to password protect public links,
+    and configure a duration after which the link will automatically expire.
+
+We are now working on the other requested features around sharing, including
+comments and reactions.

docs/docs/photos/features/sharing.md

@@ -1,41 +0,0 @@
----
-title: Sharing
-description:
-    Ente allows you to share albums and collaborate with your loved ones
----
-
-# Sharing
-
-It is easy to share your albums on Ente, end-to-end encrypted.
-
-## Links
-
-You can create links to your albums by opening an album and clicking on the
-Share icon. They are publicly accessible by anyone who you share the link with.
-They don't need an app or account.
-
-These links can be password protected, or set to expire after a while.
-
-You can read more about the features supported by Links
-[here](https://ente.io/blog/powerful-links/).
-
-## Albums
-
-If your loved ones are already on Ente, you can share an album with their
-registered email address.
-
-If they are your partner, you can share your `Camera` folder on Android, or
-`Recents` on iOS. Whenever you click new photos, they will automatically be
-accessible on your partner's device.
-
-## Collaboration
-
-You can allow other Ente users to add photos to your album. This is a great way
-for you to build an album together with someone. You can control access to the
-same album - someone can be added as a `Collaborator`, while someone else as a
-`Viewer`.
-
-If you wish to collect photos from folks who are not Ente, you can do so with
-our Links. Simply tick the box that says "Allow uploads", and anyone who has
-access to the link will be able to add photos to your album.
-[Read more](https://ente.io/blog/collect-photos/)

docs/docs/photos/features/watch-folder.md

@@ -1,36 +0,0 @@
----
-title: Watch folder
-description: Automatic syncing of certain folders in the Ente Photos desktop app
----
-
-# Watch folder
-
-_Automatic syncing_
-
-The Ente desktop app allows you to "watch" a folder on your computer for any
-changes, creating a one-way sync from your device to the Ente cloud. This is
-intended to automate your photo management and backup.
-
-## How to add Watch folders?
-
--   Click on the hamburger menu in the top left corner
--   Open the sidebar
--   Select _Watch Folders_
--   Choose _Add Watch Folders_
--   Pick the folder from your system that you want to add as a watched folder
-
-## How to remove Watch folders?
-
--   Click on the hamburger menu in the top left corner
--   Open the sidebar
--   Select _Watch Folders_
--   Click on the three dots menu next to the folders on the right side
--   Choose _Stop Watching_ from the menu
-
-# Tips:
-
--   You will get an option to choose whether to sync nested folders to a single
-    album or separate albums.
-
--   The app continuously monitors changes in the watched folder, such as the
-    addition or removal of files.

docs/docs/photos/features/watch-folders.md

@@ -0,0 +1,68 @@
+---
+title: Watch folder
+description:
+    Automatic syncing of selected folders using the Ente Photos desktop app
+---
+
+# Watch folders
+
+The Ente desktop app allows you to "watch" a folder on your computer for any
+changes, creating a one-way background sync from folders on your computer to
+Ente albums. This is intended to automate your photo management and backup.
+
+By using the "Watch folders" option in the sidebar, you can tell the desktop app
+which are the folders that you want to watch for changes. The app will then
+automatically upload new files added to these folders to the corresponding ente
+album (it will also upload them initially). And if a file is deleted locally,
+then the corresponding Ente file will also be automatically moved to
+uncategorized.
+
+Paired with the option to run Ente automatically when your computer starts, this
+allows you to automate backups to ente's cloud.
+
+### Steps
+
+1. Press the **Watch folders** button in the sidebar. This will open up a dialog
+   where you can add and remove watched folders.
+
+2. To start watching a folder, press the **Add folder** button and select the
+   folder on your laptop that you want to watch for any changes. You can also
+   drag and drop the folder here.
+
+3. If the folder has nesting, you will see two options - **A single album** and
+   **Separate albums**.
+
+    - **Single album** will create a new Ente album with the same name as the
+      folder's name, and will then sync all the changes in the folder (and any
+      nested folders) to this single album.
+
+    - **Separate albums** will create separate albums for each nested folder of
+      the selected folder, and will then sync the changes in each nested folder
+      separately.
+
+    - For example, suppose you have a folder name `Photos` on your computer, and
+      inside that folder you have two nested folders named `New Year` and
+      `Summer`. In the single album mode, the app will create an Ente album
+      named "Photos" and put all the files from both `New Year` and `Summer`
+      there. In the separate album mode, the app will create two Ente albums,
+      "New Year" and "Summer", each only containing the respective files.
+
+    - In separate album mode, only nested folders that have at least one file
+      will result in the creation of a new album – empty folders (or folders
+      that only contain other folders) will be ignored.
+
+4. After choosing any of the above options, the folder will be initially synced
+   to ente's cloud and monitored for any changes. You can now close the dialog
+   and the sync will continue in background.
+
+5. When the app is syncing in the background it'll show a small progress status
+   in the bottom right. You can expand it to see more details if needed.
+
+6. You can stop watching any folder by clicking on the three dots next to the
+   watch folder entry, and then selecting **Stop watching**.
+
+> Note: In case you start a new upload while an existing sync is in progress,
+> the sync will be paused then and resumed when your upload is done.
+
+Some more details about the feature are in our
+[blog post](http://ente.io/blog/watch-folders) announcing it.

docs/docs/photos/index.md

@@ -10,9 +10,10 @@ Photos. You can use it to safely and securely store your photos on the cloud.
 
 While security and privacy form the bedrock of Ente Photos, it is not at the
 cost of usability. The user interface is simple, and we are continuously working
-to make it even simpler. The goal is a product that can be used by people with
-all sorts of technical ability and background.
+to make it even simpler.
 
-These help docs are divided into three sections: Features, FAQ and
-Troubleshooting. Choose the relevant page from the sidebar menu, or use the
-search at the top.
+The goal is a product that can be used by people with all sorts of technical
+ability and background.
+
+These help docs are divided into four sections. Choose the relevant page from
+the sidebar menu, or use the search at the top.

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,24 @@
+---
+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,34 @@
+---
+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,19 @@
+---
+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,14 @@
+---
+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 Amazon Photos](from-amazon-photos)
+-   [Import from local hard disk](from-local-hard-disk)
+-   [Export out of Ente Photos](export/)

docs/docs/photos/troubleshooting/sharing-logs.md

@@ -17,28 +17,29 @@ the logs just make the process a bit faster and easier.
 
 #### To **_Report a bug_** on your mobile device, follow these steps:
 
-- Tap on the three horizontal lines to access the settings.
-- Tap on **"Support"** from the settings.
-- Select for the option to **"Report a Bug"**.
-- Tap on **"Report a bug"** .
+-   Tap on the three horizontal lines to access the settings.
+-   Tap on **"Support"** from the settings.
+-   Select for the option to **"Report a Bug"**.
+-   Tap on **"Report a bug"** .
 
 ### Desktop
 
 To **_Report a bug_** on the desktop app, follow these steps:
 
-- Click on the three horizontal lines located in the top left corner of the screen to access the settings.
-- Click on **"Debug logs"** from the settings.
-- Click on **Download logs**.
-- Then Click on **"Support"**.
-- Attach the downloaded logs in the email and describe the issue.
+-   Click on the three horizontal lines located in the top left corner of the
+    screen to access the settings.
+-   Click on **"Debug logs"** from the settings.
+-   Click on **Download logs**.
+-   Then Click on **"Support"**.
+-   Attach the downloaded logs in the email and describe the issue.
 
 ### Web
 
 To **_Report a bug_** on the web, follow these steps:
 
-- Click on the three horizontal lines located in the top left corner of the screen to access the settings.
-- Click on **"Debug Logs"**
-- Click on  **Download logs**
-- Click on **"Support"** from the settings.
-- Attach the downloaded logs in the email and describe the issue.
- 
+-   Click on the three horizontal lines located in the top left corner of the
+    screen to access the settings.
+-   Click on **"Debug Logs"**
+-   Click on **Download logs**
+-   Click on **"Support"** from the settings.
+-   Attach the downloaded logs in the email and describe the issue.