Skip to content

Commit 68db5e5

Browse files
AntreesyAntreesy
committed
feat(talk): add user documentation for 34 features
Signed-off-by: Maksim Sukharev <antreesy.web@gmail.com>
1 parent 8e60282 commit 68db5e5

9 files changed

Lines changed: 222 additions & 2 deletions

‎user_manual/talk/call.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,17 @@ 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 using AI-powered audio processing.
47+
48+
1. Open ``Media settings`` before or during a call
49+
2. Locate the ``Audio`` section
50+
3. Enable ``Noise suppression``
51+
52+
This is especially useful in noisy environments such as open offices or busy locations. Auto-gain control and echo cancellation are also available in the same section.
53+
4354
Backgrounds
4455
^^^^^^^^^^^
4556

‎user_manual/talk/call_from_anywhere.rst‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
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, without needing to navigate to a conversation first.
9+
10+
Quick Access
11+
============
12+
13+
Accessing the Call Menu
14+
~~~~~~~~~~~~~~~~~~~~~~~
15+
16+
1. Click on any user's avatar in your Nextcloud workspace
17+
2. The user menu appears
18+
3. Select "Call" or "Start call"
19+
4. A direct call is initiated immediately
20+
21+
Call Types Available
22+
~~~~~~~~~~~~~~~~~~~~
23+
24+
From the avatar menu, you can:
25+
26+
- **Start a direct call** with the user
27+
- **Initiate a one-to-one conversation** if preferred
28+
- **Join existing calls** if the user is already in a call
29+
30+
Benefits
31+
========
32+
33+
- **Speed**: No need to navigate to a conversation first
34+
- **Availability**: Call directly from anywhere in Nextcloud
35+
- **Efficiency**: Quickly reach colleagues without creating conversations
36+
- **Context-aware**: Call while working on files, tasks, or other activities
37+
38+
Best Practices
39+
==============
40+
41+
- **Check availability**: See if users are available before calling
42+
- **Respect preferences**: Some users may prefer messages over calls
43+
- **Use for quick connects**: Perfect for brief discussions
44+
- **Switch to groups**: Create a conversation for multi-user discussions
45+
46+
Integration Points
47+
==================
48+
49+
The "Call from anywhere" feature integrates with:
50+
51+
- Avatar menus across Nextcloud apps
52+
- User directories
53+
- Contact lists
54+
- Collaboration features in other apps
55+
56+
See Also
57+
========
58+
59+
- :doc:`call`
60+
- :doc:`conversations`
61+
- :doc:`open_conversations`

‎user_manual/talk/call_index.rst‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,9 @@ Calls
44
.. toctree::
55
:maxdepth: 1
66

7+
call_from_anywhere
78
call
89
call_screenshare
910
call_views
1011
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.
12+
call_recording

‎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 & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ Conversations
55
:maxdepth: 1
66

77
conversations
8+
conversation_organization
9+
conversation_presets
810
open_conversations
911
appearance
1012
files_integration

‎user_manual/talk/conversation_organization.rst‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
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. Tags help you group conversations by project, team, topic, or any other criteria that makes sense for your workflow.
14+
15+
Creating Tags
16+
~~~~~~~~~~~~~
17+
18+
1. Open the left sidebar
19+
2. Right-click on a conversation or use the conversation menu
20+
3. Select "Add tag" and choose an existing tag or create a new one
21+
4. The conversation will now be tagged and grouped accordingly
22+
23+
Managing Tags
24+
~~~~~~~~~~~~~
25+
26+
- **Rename tags**: Right-click on a tag header to rename it
27+
- **Delete tags**: Remove a tag (conversations are not deleted, only untagged)
28+
- **Collapse/expand**: Click on tag headers to collapse or expand grouped conversations
29+
30+
Sorting and Grouping
31+
====================
32+
33+
Customize how conversations appear in your sidebar.
34+
35+
Sorting Options
36+
~~~~~~~~~~~~~~~
37+
38+
- **Activity**: Show most recently active conversations first (default)
39+
- **Alphabetical**: Sort conversations alphabetically by name
40+
41+
Grouping Modes
42+
~~~~~~~~~~~~~~
43+
44+
- **No grouping**: Flat list of all conversations
45+
- **Group first**: Show groups/folders before private conversations
46+
- **Private first**: Show private conversations before groups/folders
47+
48+
Changing Preferences
49+
~~~~~~~~~~~~~~~~~~~~
50+
51+
1. Access your Talk preferences or settings
52+
2. Navigate to "Conversations"
53+
3. Select your preferred sort order and grouping mode
54+
4. Changes apply immediately
55+
56+
See Also
57+
========
58+
59+
- :doc:`conversations`
60+
- :doc:`open_conversations`
61+
- :doc:`calendar_integration`

‎user_manual/talk/conversation_presets.rst‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
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. Each preset applies a specific set of defaults suited to a particular use case.
14+
15+
Permanent Call Rooms
16+
====================
17+
18+
A permanent call room is a conversation preset optimized for ongoing, always-available meetings.
19+
20+
Setting Up a Permanent Call Room
21+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22+
23+
1. Create a new conversation
24+
2. Select the "Permanent call room" or "Voice room" preset
25+
3. The conversation is configured as a persistent space for calls
26+
4. Members can start or join calls at any time
27+
28+
Use Cases
29+
~~~~~~~~~
30+
31+
- Always-on rooms for team stand-ups or recurring meetings
32+
- Impromptu voice discussions without scheduling
33+
- Dedicated spaces for a team or project
34+
35+
Force Lobby
36+
===========
37+
38+
Administrators can configure a preset to force the lobby, ensuring participants wait for a moderator before joining.
39+
40+
When a conversation uses a forced lobby preset:
41+
42+
- Participants see a waiting room upon joining
43+
- A moderator must admit them to the conversation
44+
- Useful for webinars, interviews, or controlled meetings
45+
46+
See Also
47+
========
48+
49+
- :doc:`conversations`
50+
- :doc:`webinar`
51+
- :doc:`open_conversations`

‎user_manual/talk/integrations_index.rst‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
Integrations
2+
============
3+
4+
.. toctree::
5+
:maxdepth: 1
6+
7+
files_integration
8+
calendar_integration
9+
call_from_anywhere

‎user_manual/talk/messages.rst‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,3 +96,28 @@ You can edit the thread title from the thread itself or from the sidebar.
9696
.. image:: images/thread-edit-title.png
9797
:alt: Talk thread title edit option in the thread header
9898
:width: 500px
99+
100+
Private replies
101+
---------------
102+
103+
Private replies are messages sent directly to a participant in a one-to-one conversation, in response to a specific message in a group conversation while maintaining privacy.
104+
105+
1. In a group or public conversation, locate a message you want to reply to privately
106+
2. Hover over the message or access the message menu
107+
3. Select "Reply in private"
108+
4. A one-to-one conversation window opens with the original message quoted
109+
5. Type your response and send
110+
111+
The quoted message appears in your reply, providing full context of what you're responding to — including the original sender's name, message content, and timestamp.
112+
113+
Message reactions
114+
-----------------
115+
116+
Add emoji reactions to messages to quickly express agreement, celebrate, or indicate emotions without typing full responses.
117+
118+
1. Hover over a message in the chat
119+
2. Click the smiley face icon or "Add reaction" button
120+
3. Select an emoji from the picker
121+
4. The reaction appears below the message with a count
122+
123+
Click on a reaction to see who reacted. To remove your reaction, click the X or click the emoji again.

0 commit comments

Comments
 (0)