docs: Update *About streams and topics* doc.

This commit is contained in:
Cynthia Lin
2017-01-27 15:03:43 -08:00
committed by Tim Abbott
parent 969b6db7ed
commit c739e6e752

View File

@@ -17,19 +17,20 @@ only visible to users who've been invited to subscribe to them. Users who
are not members of a private stream cannot subscribe to the stream, and
they also cannot read or send messages to the stream.
Users are subscribed to specific streams in the organization by default, such as
the [#announce](the-announce-stream) stream. Users can easily
[view messages](/help/view-messages-from-a-stream) from a specific stream; in
addition, they can [browse](/help/browse-and-subscribe-to-streams#browse-streams) their
stream subscriptions using the Zulip stream browser.
Users are subscribed to specific streams in the organization by default,
such as the [#announce](the-announce-stream) stream. Users can easily
[view messages](/help/view-messages-from-a-stream) from a specific stream;
in addition, they can
[browse](/help/browse-and-subscribe-to-streams#browse-streams) their stream
subscriptions using the Zulip stream browser.
If they wish to read messages from a stream that they're not subscribed to,
users can choose to [join](/help/browse-and-subscribe-to-streams#subscribing-to-streams)
a stream. Similarly, if they are not interested in the topics being discussed in
a stream, users can choose to [unsubscribe](/help/unsubscribe-from-a-stream) from a
stream.
Users can also customize their stream settings; they can:
users can choose to
[join](/help/browse-and-subscribe-to-streams#subscribing-to-streams) a
stream. Similarly, if they are not interested in the topics being discussed
in a stream, users can choose to
[unsubscribe](/help/unsubscribe-from-a-stream) from a stream. Users can
also customize their stream settings; they can:
* [pin a stream](/help/pin-a-stream)
* [change the color of streams](/help/change-the-color-of-a-stream)
@@ -37,30 +38,29 @@ Users can also customize their stream settings; they can:
* [muting notification for streams](/help/mute-a-stream)
If enabled by the organization administrators, users can
[create](/help/create-a-stream) streams and [invite](/help/add-or-invite-someone-to-a-stream)
other users to a stream.
[create](/help/create-a-stream) streams and
[invite](/help/add-or-invite-someone-to-a-stream) other users to a stream.
Only organization administrators can modify a stream, like:
Only organization administrators can modify a stream; they can:
* [renaming a stream](/help/rename-a-stream)
* [deleting a stream](/help/delete-a-stream)
* changing the description of a stream
* [removing users from a stream](/help/remove-someone-from-a-stream)
* [changing the accessibility of a stream](/help/change-the-accessibility-of-a-stream)
* [rename a stream](/help/rename-a-stream)
* [delete a stream](/help/delete-a-stream)
* [change the description of a stream](/help/change-the-stream-description)
* [remove users from a stream](/help/remove-someone-from-a-stream)
* [change the accessibility of a stream](/help/change-the-accessibility-of-a-stream)
## About topics
In each stream, messages are sorted by topics. Topics are
specific, fine-grained subjects that fit with the overall subject of the
stream that they're sent to. Topics ensure sequential messages
about the same thing are threaded together, allowing for better consumption
by users.
In each stream, messages are sorted by topics. Topics are specific,
fine-grained subjects that fit with the overall subject of the stream that
they're sent to. Topics ensure sequential messages about the same thing are
threaded together, allowing for better reception for users.
!!! tip ""
The best stream topics are short and specific. For example, for a bug
tracker integration, a good topic would be the bug number; for an
integration like Nagios, the service would serve as a good topic.
Users can easily [change the topics](/help/change-the-topic-of-a-message) of the messages
that they sent if they sent the message to the wrong topic or if some
messages in a topic have gone off-topic.
Users can easily [change the topics](/help/change-the-topic-of-a-message) of
the messages that they sent if they sent the message to the wrong topic or
if some messages in a topic have gone off-topic.