user docs: Update create-a-stream.

This commit is contained in:
Rishi Gupta 2018-09-15 22:28:43 -07:00
parent 29abb80c96
commit bbce4162ba

View File

@ -1,69 +1,45 @@
# Create a stream
Streams can either be public to anyone in the organization, or require an
invitation to join. Organization admins can always see the names and
membership of private streams, but cannot read any of the messages.
By default, anyone can create streams in a Zulip organization.
Organization administrators can
[restrict stream creation](/help/configure-who-can-create-streams) to
admins only, or to users meeting a minimum account age.
If you are an administrator setting up streams for the first time, we highly
recommend reading our
[guide to streams](/help/getting-your-organization-started-with-zulip#create-streams)
first.
## Create a new stream
## Create a stream
{!subscriptions.md!}
{relative|stream|all}
3. Click the plus (<i class="icon-vector-plus"></i>) icon to the right of
the **Filter streams** input.
1. Click **Create stream** on the right.
!!! warn ""
**Note:** If you do not see the plus
(<i class="icon-vector-plus"></i>) icon, it
is probably because your organization's administrators
have disabled stream creation for ordinary users.
If that's the case, then you need to ask them to
allow ordinary users to create streams, or you will have
to ask an administrator for help creating each particular stream.
1. Fill out the requested info, and click **Create**.
4. After clicking the plus (<i class="icon-vector-plus"></i>) icon, at
right side of the [Streams](/#streams) page, labeled
**Create stream**, will now display options for creating a stream.
!!! warn ""
You will only see the **Create stream** button if you have
permission to create streams.
5. Enter the title of your stream in the **Stream name** input.
If you designate your stream as public, the **Stream name** will be
displayed under the Streams on the left sidebar. Your stream name must
be unique to all other stream names and can be no longer than
60 characters.
## Stream options
!!! tip ""
You can optionally enter a brief description of your stream in
**Stream description** to give other users a general idea of
what's being discussed in your stream. The description can be
seen under the stream name in the stream overview.
There are several parameters you can set while creating a stream. All but
**Announce stream** you can change later.
7. The **Stream privacy** option controls the privacy of your
stream. There are two options:
* **Anybody can join** - This option makes your stream **public**
and accessible to all users.
* **Stream name**: Appears in the left sidebar for subscribed users. The
stream name can be in any language, and can include spaces and other
punctuation.
* **People must be invited** - This option makes your stream
**private**. Only users you invite will be able to access this stream.
Only the creator of the stream can invite new users this stream.
* **Stream description**: Helps users decide whether to subscribe when they
are browsing streams.
8. If your stream is public, you can choose to alert users about the new
stream by clicking the **Announce stream** checkbox. Users who have been
added to the new stream will always be notified, but if the
**Announce stream** feature is enabled, all users will be notified
of the stream's creation.
* **Announce stream**: Posts a message to `#announce` advertising the new
stream. Organization administrators can change the stream used for stream
creation announcements in organization settings.
9. To automatically subscribe a user to your stream, scroll down to
**People to add** and tick the checkboxes with the names of the users
you want to add.
* **Stream permissions**: See [Stream permissions](/help/stream-permissions).
!!! tip ""
To search for specific users, enter their usernames in the
**Filter names** box.
10. Once you are ready to create your stream,
click the **Create** button. The stream will now appear
in the left sidebar for the users that you subscribed.
* **People to add**: You can copy the membership from an existing stream, or
enter users one by one.