mirror of https://github.com/zulip/zulip.git
user docs: Update getting-started-with-zulip.
This commit is contained in:
parent
f875b33a23
commit
47fb9c0900
|
@ -4,19 +4,23 @@ Welcome to Zulip! Like any new tool, mastering Zulip will take some time,
|
||||||
but once you get the hang of it, you'll never want to use another chat
|
but once you get the hang of it, you'll never want to use another chat
|
||||||
service again.
|
service again.
|
||||||
|
|
||||||
Zulip is designed around a few key ideas:
|
## Understand
|
||||||
|
|
||||||
- You spend far more time reading communications than writing them. So
|
Read our [guide to streams and topics](/help/about-streams-and-topics) to familiarize
|
||||||
Zulip is primarily designed to optimize consuming messages; either reading
|
yourself with Zulip's conversation model.
|
||||||
them, or making an informed decision not to read them.
|
|
||||||
- Messages in Zulip are organized into streams and topics. Streams are
|
If this is your first time using Zulip, we recommend starting with the web
|
||||||
similar to chatrooms, IRC channels, and email lists in that they determine
|
or desktop experience.
|
||||||
who receives the message. Each conversation in a stream also has a topic,
|
|
||||||
which plays the role of the subject line of an email (though topics are
|
## Set up your account
|
||||||
usually shorter, e.g. "logo" or "logo design", not "feedback on the new
|
|
||||||
logo design?") in that it organizes messages into threads.
|
- [Set a profile picture](/help/change-your-avatar)
|
||||||
- Zulip keeps careful track of which messages and threads you've read, and
|
- Get the [mobile and desktop apps](/apps)
|
||||||
always places you exactly where you left off.
|
- [Browse and subscribe to streams](/help/browse-and-subscribe-to-streams)
|
||||||
|
- [Configure your notifications](/#settings/notifications) to work the way
|
||||||
|
you do. If you're joining a low traffic organization and aren't using the
|
||||||
|
desktop app, consider sending all messages to email.
|
||||||
|
- [Review your settings](/help/review-your-settings)
|
||||||
|
|
||||||
## Basic workflows
|
## Basic workflows
|
||||||
|
|
||||||
|
@ -26,11 +30,12 @@ A few basic workflows are useful when getting oriented.
|
||||||
|
|
||||||
- Use the left sidebar (or the `n` key) to review messages thread-by-thread.
|
- Use the left sidebar (or the `n` key) to review messages thread-by-thread.
|
||||||
- Use the down arrow key (`↓`) to move the cursor to the next message.
|
- Use the down arrow key (`↓`) to move the cursor to the next message.
|
||||||
- Use the End key to mark all messages in the current view as read (could be
|
- Use the End key to mark all messages in the current view as read.
|
||||||
a thread, stream, or anything else).
|
|
||||||
|
|
||||||
### For writing
|
### For writing
|
||||||
|
|
||||||
|
- To reply to a message, click on it, or use `r` or `Enter` to reply to the
|
||||||
|
message under the blue box.
|
||||||
- When starting a new conversation, remember to start a new topic. Don't
|
- When starting a new conversation, remember to start a new topic. Don't
|
||||||
overthink it; the first 2-3 words that come to your mind are probably
|
overthink it; the first 2-3 words that come to your mind are probably
|
||||||
fine. Using topics may take some attention at the beginning, but after a
|
fine. Using topics may take some attention at the beginning, but after a
|
||||||
|
@ -38,21 +43,14 @@ A few basic workflows are useful when getting oriented.
|
||||||
- It is totally normal to have 5 conversations happening in a stream at the
|
- It is totally normal to have 5 conversations happening in a stream at the
|
||||||
same time; each on its own topic. So don't worry about interrupting; each
|
same time; each on its own topic. So don't worry about interrupting; each
|
||||||
conversation has its own space.
|
conversation has its own space.
|
||||||
- If you see a conversation where the last message was sent a few hours (or
|
- It is totally normal for conversations to last many hours or days, even in
|
||||||
days!) ago, feel free to reply anyway. It'll be easy for everyone to see
|
busy streams. Don't worry about replying long after a message is sent;
|
||||||
your reply in context, regardless of anything else that has happened on
|
everyone will see your reply in context.
|
||||||
the stream in the meantime.
|
|
||||||
|
|
||||||
## Next steps
|
## Advanced
|
||||||
|
|
||||||
Once you've figured out the basics, you'll probably want to:
|
- Master a few [keyboard shortcuts](/help/keyboard-shortcuts). Start
|
||||||
|
|
||||||
- [Add an avatar](/#settings/your-account)
|
|
||||||
- [Get the mobile and desktop apps](/apps)
|
|
||||||
- [Configure your notifications](/#settings/notifications) to work the way
|
|
||||||
you do.
|
|
||||||
- [Browse the streams](/#streams/all) in your organization and join those of
|
|
||||||
interest.
|
|
||||||
- Master Zulip's [keyboard shortcuts](/help/keyboard-shortcuts). Anything
|
|
||||||
you can do with the mouse, you can do even faster from the keyboard. Start
|
|
||||||
with `n`, `↓`, `c`, and `Enter`, and use `?` for help.
|
with `n`, `↓`, `c`, and `Enter`, and use `?` for help.
|
||||||
|
- Learn how to
|
||||||
|
[format your messages](/help/format-your-message-using-markdown) using
|
||||||
|
Markdown.
|
||||||
|
|
Loading…
Reference in New Issue