fix(user): Split talk user documentation into pieces

Signed-off-by: Joas Schilling <[email protected]>

Author: nickvergessen

user_manual/talk/advanced_features.rst

@@ -0,0 +1,33 @@
+===========
+Attachments
+===========
+
+Sharing files in a chat
+-----------------------
+
+You can share files in a chat in 3 ways.
+
+First, you can simply drag'n'drop them on the chat.
+
+.. image:: images/drag-and-drop.png
+   :width: 600px
+
+Second, you can select a file from your Nextcloud Files or a file manager by choosing the little paperclip and selecting where you'd like to pick the file from.
+
+.. image:: images/share-files-in-chat.png
+   :width: 500px
+
+.. image:: images/share-files-in-chat-selection.png
+    :width: 600px
+
+You can add more files until you are done and decide to share the files. You can also add a text caption to your shared files, providing a brief description or context.
+
+.. image:: images/talk-upload-files.png
+   :width: 500px
+
+All users will be able to click the files to view, edit or download them, irrespective of them having a user account. Users with an account will have the file automatically shared with them while external guest users will get them shared as a public link.
+
+.. image:: images/editing-document-in-chat-room.png
+   :width: 600px
+
+.. FIXME Add polls, voice messages?, shared items view

user_manual/talk/attachments.rst

@@ -0,0 +1,21 @@
+:orphan:
+Bots
+====
+
+.. FIXME Replace with bots as commands are removed, or remove?
+
+Commands
+--------
+
+Nextcloud allows users to execute actions using commands. A command typically looks like:
+
+    ``/wiki airplanes``
+
+Administrators can configure, enable and disable commands. Users can use the ``help`` command to find out what commands are available.
+
+    ``/help``
+
+.. image:: images/command-help.png
+    :width: 600px
+
+Find more information in the `administrative documentation for Talk. <https://nextcloud-talk.readthedocs.io/en/stable/commands/>`_

user_manual/talk/bots.rst

@@ -0,0 +1,51 @@
+Breakout rooms
+==============
+
+Breakout rooms allow you to divide a Nextcloud Talk call into smaller groups for more focused discussions. The moderator
+of the call can create multiple breakout rooms and assign participants to each room.
+
+.. note:: Breakout rooms are currently not available in conversations that are joinable by guests (public conversations).
+
+Configure breakout rooms
+------------------------
+
+To create breakout rooms, you need to be a moderator in a group conversation. Click on the top-bar menu and click on
+"Setup breakout rooms".
+
+.. image:: images/talk-breakout-rooms-setup.png
+    :width: 400px
+
+A dialog will open where you can specify the number of rooms you want to create and the participants assignment method.
+Here you'll be presented with 3 options:
+
+- **Automatically assign participants**: Talk will automatically assign participants to the rooms.
+- **Manually assign participants**: You'll go through a participants editor where you can assign participants to rooms.
+- **Allow participants choose**: Participants will be able to join breakout rooms themselves.
+
+.. image:: images/talk-breakout-rooms-setup-dialog.png
+    :width: 500px
+
+Manage breakout rooms
+---------------------
+
+Once the breakout rooms are created, you will be able to see them in the sidebar.
+
+.. image:: images/talk-breakout-rooms-sidebar.png
+    :width: 500px
+
+From the sidebar header
+
+- **Start and stop the breakout rooms**: this will move all the users in the parent conversation to their respective breakout rooms.
+- **Broadcast a message to all the rooms**: this will send a message to all the rooms at the same time.
+- **Make changes to the assigned participants**: this will open the participants editor where you can change which participants are assigned to which breakout room. From this dialog it's also possible to delete the breakout rooms.
+
+.. image:: images/talk-breakout-rooms-sidebar-header.png
+    :width: 400px
+
+From the breakout room element in the sidebar, you can also join a particular breakout room or send a message to a
+specific room.
+
+.. image:: images/talk-breakout-rooms-sidebar-item.png
+    :width: 400px
+
+.. FIXME Ask for assistance, demo "free selection for a user"