user documentation for sharing

Signed-off-by: Sascha Wiswedel <sascha.wiswedel@nextcloud.com>

user_manual/files/access_webgui.rst

@@ -198,20 +198,10 @@ Moving files
 
 You can move files and folders by dragging and dropping them into any directory.
 
-
-Change in share expiration date
--------------------------------
-
-In older versions of Nextcloud, you could set an expiration date on both local
-and public shares. Now you can set an expiration date only on public shares,
-and local shares do not expire when public shares expire. The only way to
-"expire" a local share is to click the trash can icon to un-share your files.
-
 Creating or connecting to a Federation Share link
 -------------------------------------------------
 
 Federated Cloud Sharing allows you to mount file shares from remote Nextcloud
-servers, and manage them just like a local share. In Nextcloud 9 the process for
-creating a new sharing link is easier and more streamlined. See
-:doc:`federated_cloud_sharing` to learn to how to create and connect to new
+servers and manage them just like a local share. See
+:doc:`sharing` to learn to how to create and connect to new
 Federated Cloud shares.

user_manual/files/index.rst

@@ -11,7 +11,7 @@ Files & synchronization
    deleted_file_management
    desktop_mobile_sync
    encrypting_files
-   federated_cloud_sharing
+   sharing
    file_drop
    large_file_upload
    quota

user_manual/files/sharing.rst

@@ -0,0 +1,112 @@
+============
+File Sharing
+============
+
+Nextcloud users can share files and folders. Possible targets are
+
+* public links
+* users
+* groups
+* circles
+* talk conversations
+* users or groups on federated Nextcloud servers
+
+
+Public link shares
+------------------
+
+You can share files and folders via public links.
+
+A random 15-digit token will be created. The link will look like ``https://cloud.mydomain.org/s/yxcFKRWBJqYYzp4``.
+
+A number of options are available for public *folder* shares:
+
+.. figure:: ../images/sharing_public_folder.png
+
+* **Read only** to allow viewing and downloading
+* ** Allow upload and editing**
+* With ** File drop**, the sharee can only upload files to a folder without seeing the files that are already in that folder.
+* **Hide download** prevents the sharee from downloading
+* **Password protect**
+* **Set expiration date** will automatically disable the share
+* **Note to recipient**
+* **Unshare** to revert the share
+* **Add another link** to create multiple public links with different rights
+
+For public *file* shares, you may allow editing the file with one of Nextcloud's collaborative editing solutions.
+
+.. figure:: ../images/sharing_public_file.png
+
+
+Internal shares with users and groups
+-------------------------------------
+
+When sharing with users, groups, circles or members of a Talk conversation, rights for the files or folder contents are adjustable:
+
+.. figure:: ../images/sharing_internal.png
+
+As a sharee, you can configure if you automatically want to accept all incoming shares and have them added to your root folder, or if you 
+want to be asked each time if you want to accept or decline the share.
+
+.. figure:: ../images/sharing_internal_acceptNotification.png
+
+For adjusting the acceptance setting, go to **Settings** > **Personal** > **Sharing**
+
+.. figure:: ../images/sharing_autoAcceptSetting.png
+
+
+Others with access
+------------------
+
+In order to find out if a file or folder is accessible to others through sharing of a superior folder 
+hierarchy level, click on **Others with access** in the sharing tab.
+
+.. figure:: ../images/sharing_others-with-access__collapsed.png
+
+The list shows all users, groups, chats etc. that the current object has been given access to through
+sharing of a superior folder in the hierarchy.
+
+.. figure:: ../images/sharing_others-with-access__details.png
+
+Click on the three dots to
+
+* see who initiated the share
+* see where the share was initiated (click to navigate to the folder, as far as you have access there)
+* unshare the initial share (only accessible for the share owner)
+
+
+.. note:: This information is only visible to the owner of a file/folder or sharees with resharing rights.
+
+
+================
+Federated Shares
+================
+
+Federation Sharing allows you to mount file shares from remote Nextcloud servers, in effect 
+creating your own cloud of Nextclouds. You can create direct share links with 
+users on other Nextcloud servers.
+
+Creating a new Federation Share
+-------------------------------
+
+Federation sharing is enabled by default. Follow these steps to create a new share with other Nextcloud or ownCloud servers:
+
+Go to your ``Files`` page and click the Share icon on the file or directory 
+you want to share. In the sidebar enter the username and URL of the remote user
+in this form: ``<username>@<nc-server-url>``. In this example, that is
+``Lucy@cloud.lucysdomain.org``.
+
+.. figure:: ../images/share-federation-1.png
+
+The sharee is receiving a notification in their Nextcloud, allowing them to either accept or decline the incoming share.
+
+.. figure:: ../images/share-federation-2-notification.png
+
+
+Adding a public share to your Nextcloud
+---------------------------------------
+
+Nextcloud public link share pages offer an option to add that file or folder as a federated share into your own Nextcloud instance.
+Just enter your ``<username>@<nc-server-url>`` just like shown for outbound shares above:
+
+.. figure:: ../images/share-federation-3-public.png