Import feature pages from website

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",
@@ -33,15 +50,15 @@ export const sidebar = [
                     },
                     { text: "Quick link", link: "/photos/features/quick-link" },
                     { text: "Referrals", link: "/photos/features/referrals" },
-                    { text: "Sharing", link: "/photos/features/sharing" },
+                    { 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",
                     },
                 ],
             },
@@ -76,7 +93,17 @@ export const sidebar = [
                     },
                 ],
             },
-            { text: "FAQ", link: "/photos/faq/" },
+            {
+                text: "FAQ",
+                collapsed: true,
+                items: [
+                    { text: "General", link: "/photos/faq/general" },
+                    {
+                        text: "Hide & archive",
+                        link: "/photos/faq/hidden-and-archive",
+                    },
+                ],
+            },
             {
                 text: "Troubleshooting",
                 collapsed: true,
@@ -216,7 +243,7 @@ function sidebarOld() {
                         },
                         {
                             text: "Watch folder",
-                            link: "/photos/features/watch-folder",
+                            link: "/photos/features/watch-folders",
                         },
                         { text: "Trash", link: "/photos/features/trash" },
                         {

docs/docs/photos/faq/general.md

@@ -0,0 +1,9 @@
+---
+title: General FAQ
+description: An assortment of frequently asked questions about Ente Photos
+---
+
+# FAQ
+
+While moOn this page we'll document some help items in a question and
+answer format.

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/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,62 @@
+---
+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/free-up-space/index.md

@@ -0,0 +1,19 @@
+---
+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/share.md

@@ -0,0 +1,76 @@
+---
+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.