Skip to content

Commit 85ef621

Browse files
committed
feat(talk): add user documentation for 34 features
Signed-off-by: Maksim Sukharev <antreesy.web@gmail.com>
1 parent 5cb9b03 commit 85ef621

19 files changed

Lines changed: 198 additions & 4 deletions

user_manual/talk/call.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,21 @@ Device settings allow you to choose which microphone and camera you want to use.
4040
:alt: Talk media settings showing microphone and camera device selection
4141
:width: 400px
4242

43+
Noise suppression
44+
^^^^^^^^^^^^^^^^^
45+
46+
Enable noise suppression to reduce background noise during calls with following steps:
47+
48+
1. Open ``Media settings`` before or during a call
49+
2. Locate the ``Microphone settings`` section
50+
3. Enable ``Noise suppression`` at desired level
51+
52+
Auto-gain control and echo cancellation options are also available in the same section.
53+
54+
.. image:: images/media-settings-noise-suppression.png
55+
:alt: Talk media settings showing microphone options
56+
:width: 400px
57+
4358
Backgrounds
4459
^^^^^^^^^^^
4560

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
.. SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
2+
.. SPDX-License-Identifier: CC-BY-4.0
3+
4+
===================
5+
Call from anywhere
6+
===================
7+
8+
Start a call with any user directly from the avatar menu.
9+
No need to navigate to a conversation first; call while working on files, tasks, or other activities!
10+
11+
Accessing the call menu
12+
-----------------------
13+
14+
1. Click on a user's avatar from any app in your Nextcloud workspace to open a menu
15+
2. Select ``Call {user}``
16+
3. A direct call is initiated immediately in a floating window
17+
18+
.. image:: images/call-anywhere-initiate.png
19+
:alt: Nextcloud contacts menu with call actions
20+
:width: 300px
21+
22+
.. image:: images/call-anywhere-floating.png
23+
:alt: Floating Talk call in Files app
24+
:width: 500px
25+
26+
Best Practices
27+
~~~~~~~~~~~~~~
28+
29+
- **Check availability**: Check user status to see whether people are available before calling
30+
- **Respect preferences**: Some may prefer messages over calls. Could this have been an e-mail?
31+
- **Switch to groups**: Create a dedicated conversation for multi-user discussions
32+
33+
See also:
34+
35+
- :doc:`call`
36+
- :doc:`conversations`
37+
- :doc:`open_conversations`

user_manual/talk/call_index.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,5 @@ Calls
88
call_screenshare
99
call_views
1010
call_transcription
11-
.. call_audio FIXME Document echo cancellation, noise suppression and auto-gain control settings available in the media settings dialog before and during a call.
11+
call_recording
12+
call_from_anywhere

user_manual/talk/chat_index.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,3 @@ Chat
88
messages
99
message_integrations
1010
attachments
11-
.. bots

user_manual/talk/conversation_index.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Conversations
55
:maxdepth: 1
66

77
conversations
8+
conversation_organization
9+
conversation_presets
810
open_conversations
911
appearance
10-
files_integration
11-
calendar_integration
Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
.. SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
2+
.. SPDX-License-Identifier: CC-BY-4.0
3+
4+
========================
5+
Organizing conversations
6+
========================
7+
8+
Nextcloud Talk offers features to organize and manage your conversations efficiently.
9+
10+
Tags
11+
----
12+
13+
Create custom tags to categorize your conversations and keep them organized.
14+
Tags help you group conversations by project, team, topic, or any other criteria that makes sense for your workflow.
15+
16+
.. image:: images/conversations-tag-overview.png
17+
:alt: Talk conversations tag appearance
18+
:width: 400px
19+
20+
1. Select a conversation and open actions menu
21+
2. Select ``Tags`` and choose an existing tag or create a new one
22+
3. The conversation will now be tagged and grouped accordingly
23+
24+
You can later manage existing tags by renaming, reordering or deleting them.
25+
26+
.. image:: images/conversations-tag-actions.png
27+
:alt: Talk conversations tag actions
28+
:width: 400px
29+
30+
Sorting and grouping
31+
--------------------
32+
33+
You can additionally customize how conversations appear in the list.
34+
They can be sorted:
35+
36+
- **By last activity**: Show most recently active conversations first (default)
37+
- **Alphabetically**: Sort conversations alphabetically by name
38+
39+
Similar types can also be grouped together:
40+
41+
- **Do not group by type**: Keep a flat list of all conversations
42+
- **Show private ones first**: Show private conversations before groups/public
43+
- **Show group ones first**: Show groups/public conversations before private
44+
45+
.. image:: images/conversations-sorting.png
46+
:alt: Talk conversations sorting and grouping options
47+
:width: 400px
48+
49+
See also:
50+
51+
- :doc:`conversations`
52+
- :doc:`open_conversations`
53+
- :doc:`calendar_integration`
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
.. SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
2+
.. SPDX-License-Identifier: CC-BY-4.0
3+
4+
======================
5+
Conversation presets
6+
======================
7+
8+
Conversation presets allow administrators to define templates for new conversations, with pre-configured settings such as permissions, lobby rules, and conversation type.
9+
10+
Available presets
11+
-----------------
12+
13+
Depending on your instance configuration, you may see presets when creating a new conversation.
14+
Each preset applies a specific set of defaults suited to a particular use case.
15+
16+
.. image:: images/new-conversation-presets.png
17+
:alt: Talk new conversation dialog with presets selection
18+
:width: 400px
19+
20+
Voice room
21+
----------
22+
23+
A permanent call room ("Voice room") is a conversation preset optimized for non-obligatory, always-available meetings.
24+
Any person entering the conversation will be joining the call there, making it easier to start communicating.
25+
Messages in voice room conversation are set to expire after certain time, to keep it lightweight and spontaneous.
26+
27+
Webinar
28+
-------
29+
30+
Moderators can configure a preset to force the lobby, ensuring participants wait for a moderator before joining.
31+
When a conversation uses a forced lobby preset:
32+
33+
- Participants see a waiting room upon joining
34+
- A moderator must allow them to the conversation or lift the lobby
35+
- Useful for webinars, interviews, or controlled meetings
36+
37+
Presentation
38+
------------
39+
40+
Presentation preset is useful for internal meetings, where it is expected to have more listeners than speakers.
41+
Participant permissions are optimized to ensure the best performance and moderation experience, allowing presenters to speak uninterrupted.
42+
43+
See also:
44+
45+
- :doc:`conversations`
46+
- :doc:`webinar`
47+
- :doc:`open_conversations`
367 KB
Loading
23.8 KB
Loading
84.9 KB
Loading

0 commit comments

Comments
 (0)