From fc656c96401dddb73f153ac057c3f97933ad27ea Mon Sep 17 00:00:00 2001 From: Abin Simon Date: Fri, 29 Dec 2023 11:17:36 +0530 Subject: [PATCH] Add a product behavior section in docs --- website/docs/support/known-issues.md | 64 +++++++++++++++++++--------- 1 file changed, 43 insertions(+), 21 deletions(-) diff --git a/website/docs/support/known-issues.md b/website/docs/support/known-issues.md index 52ac0ccd3..21f94b8b0 100644 --- a/website/docs/support/known-issues.md +++ b/website/docs/support/known-issues.md @@ -1,39 +1,61 @@ -# Known issues +# Known issues and limitations -Below is a list of known Corso issues and limitations: +## Issues -* Corso supports Exchange (email, calendars, contacts), OneDrive (files) and SharePoint (Document Libraries) M365 data. +The following are the issues that we're currently aware of within the project. + +## General + +- Corso supports Exchange (email, calendars, contacts), OneDrive (files) and SharePoint (Document Libraries) M365 data. Additional data types and services will be added in subsequent releases. -* Backups of Exchange email may not include changes to the read status of an email if no other changes - to the email have been made since the previous backup. - -* Restoration of Nested attachments within Exchange Mail or Calendars aren't yet supported. - -* Folders and Calendars containing zero items or subfolders aren't included in the backup. - -* Provides no guarantees the inclusion of data that's moved, added, or deleted +- Provides no guarantees the inclusion of data that's moved, added, or deleted from M365 while a backup creation is running. The next backup creation will correct any missing data. -* Sharing information of items in OneDrive/SharePoint using sharing links aren't backed up and restored. +### Drive items (OneDrive/SharePoint) -* Permissions/Access given to a site group can't be restored. +- Permissions/Access given to a site group can't be restored. -* If a link share is created for an item with inheritance disabled +- If a link share is created for an item with inheritance disabled (via the Graph API), the link shares restored in that item will not be inheritable by children. -* Link shares with password protection can't be restored. +### Exchange -* Teams conversation replies are only backed up if the parent message is available at the time of backup. +- Backups of Exchange email may not include changes to the read status of an email if no other changes + to the email have been made since the previous backup. -* Groups SharePoint files don't support Export. This limitation will be addressed in a follow-up release +- Restoration of Nested attachments within Exchange Mail or Calendars aren't yet supported. -* Teams messages don't support Restore due to limited Graph API support for message creation. +- Calendars containing zero items or subfolders aren't included in the backup. -* Groups and Teams support is available in an early-access status, and may be subject to breaking changes. +- Backing up a group mailbox item may fail if it has a large number of attachments (500+). -* Restoring the data into a different Group from the one it was backed up from isn't currently supported. +### Teams -* Backing up a group mailbox item may fail if it has a large number of attachments (500+). +- Teams conversation replies are only backed up if the parent message is available at the time of backup. + +- Groups and Teams support is available in an early-access status, and may be subject to breaking changes. + +- Restoring the data into a different Group from the one it was backed up from isn't currently supported. + +## Limitations + +Following are unexpected behaviors or inherent limitations of the project. + +### Drive items (OneDrive/SharePoint) + +- Link shares with password protection can't be restored. + +- Restored link shares always generate different links from the original. + +- Anonymous link shares (link shares which aren't associated with any user) aren't restored. + +### Exchange + +- Exports of multipart emails containing both HTML and text versions will only produce the HTML version of the email. + +### Teams + +- Teams messages don't support restore due to limited Graph API support for message creation.