Skip to content

Commit

Permalink
help: Improve documentation about starting a new conversation.
Browse files Browse the repository at this point in the history
Document new ways to do it from the left sidebar.
  • Loading branch information
alya authored and timabbott committed Oct 25, 2024
1 parent 1de1570 commit 29b2eeb
Show file tree
Hide file tree
Showing 4 changed files with 32 additions and 22 deletions.
40 changes: 23 additions & 17 deletions help/include/how-to-start-a-new-topic.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,36 @@
{start_tabs}

{tab|desktop-web}
{tab|via-left-sidebar}

1. Click the **Start new conversation** button at the bottom of the app, or
use the <kbd>C</kbd> keyboard shortcut.
1. Click the **plus** (<i class="zulip-icon zulip-icon-square-plus"></i>) button next
to the name of the channel where you'd like to start a conversation.

1. _(optional)_ You can change the destination channel for your message using
the dropdown in the top left of the compose box. You can start typing to
filter channels.

1. Enter a topic name. Auto-complete will provide suggestions for previously
used topics.
1. Enter a topic name. Think about finishing the sentence: “Hey, can we chat about… ?”

{!compose-and-send-message.md!}

!!! tip ""
!!! keyboard_tip ""

You can also use the <kbd>C</kbd> keyboard shortcut to start a new topic in
the channel you're viewing.

{tab|via-compose-box}

You can click on the
**Clear topic** (<i class="zulip-icon zulip-icon-close"></i>) icon
near the upper right of the compose box to erase the topic name.
1. Click the **Start new conversation** button at the bottom of the app.

1. _(optional)_ You can change the destination channel for your message using
the dropdown in the top left of the compose box. Start typing to filter
channels.

1. Enter a topic name. Think about finishing the sentence: “Hey, can we chat
about… ?”

{!compose-and-send-message.md!}

!!! warn ""
!!! keyboard_tip ""

In Zulip, you can compose a message to a different place than the one you
are viewing. In this situation, the message feed will fade to indicate
what's going on.
You can also use the <kbd>C</kbd> keyboard shortcut to start a new topic in
the channel you're viewing.

{tab|mobile}

Expand Down
5 changes: 3 additions & 2 deletions help/include/send-dm.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,9 @@

{tab|desktop-web}

1. Click the **New direct message** button at the bottom of the app, or the
**Start new conversation** button if you are in a direct message view.
1. Click the **plus** (<i class="zulip-icon zulip-icon-square-plus"></i>) button next
to **DIRECT MESSAGES** in the left sidebar, or the **New direct message**
button at the bottom of the app.

1. Start typing the name of the person or [group](/help/user-groups) you want to
message, and select their name from the list of suggestions. You can continue
Expand Down
7 changes: 4 additions & 3 deletions help/include/when-to-start-a-new-topic.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Topic names should be brief but specific, for example:
* **Not so good topic names:** "question", "hi", "help", "this topic is about
a question I have about topics"

!!! tip ""
Don't overthink naming your topic. The first 2-3 words that come to mind
are probably fine!

Don't stress about making it perfect! The first 2-3 words that
come to mind are probably fine, and you can always [change it
later](/help/rename-a-topic).
2 changes: 2 additions & 0 deletions help/introduction-to-topics.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@

## How to start a new topic

Zulip lets you start a new conversation in any channel, no matter where you are.

{!how-to-start-a-new-topic.md!}

## Further reading
Expand Down

0 comments on commit 29b2eeb

Please sign in to comment.