zulip/templates/zerver/help/getting-your-organization-s...

124 lines
4.9 KiB
Markdown
Raw Normal View History

# Getting your organization started with Zulip
Use this as a checklist to get your organization off to a great start.
## Organization settings
* Add an organization [icon and description](/help/create-your-organization-profile) to
customize your login/registration pages as well as how your
organization appears in the desktop and mobile apps.
* Do a [quick review](/help/review-your-organization-settings)
of all the organization settings available.
## Create streams
Most messages in Zulip are sent to streams. Streams are similar to chat
rooms, email lists, and IRC/Slack channels, in that they determine who
receives a message. A few suggestions:
* It's often better to start with fewer streams, and let the number of
streams grow organically. For small teams, you can start with the default
streams and iterate from there.
* For large organizations, we recommend using a consistent naming
scheme, like `#marketing/<name>` or `#mk/<name>` for all streams
pertaining to the marketing team, `#help/<team name>` for
`<team name>`'s internal support stream, etc.
* A `#zulip help` stream can be useful for providing internal Zulip support
and answering questions about Zulip.
* For open source projects or other volunteer organizations, consider
adding default streams like `#announce` for announcements, `#new
members` for new members to introduce themselves and be welcomed,
and `#help` so that there's a clear place users stopping by with
just a single question can post.
* Add clear descriptions to your streams (especially public streams).
A few relevant help center articles:
* [Create a stream](/help/create-a-stream)
* [Set the default streams](/help/set-default-streams-for-new-users)
for new members.
* [Rename a stream](/help/rename-a-stream)
## Understand topics
Zulips topics are life-changing, but it can take a bit of time for everyone
to learn how to use them effectively. It helps a lot if there are at least a
few people who understand the conversation model at the beginning.
* Read our [guide to streams and topics](/help/about-streams-and-topics),
and send it out to a few people who you think would be good stewards of
the organization.
* If you're unsure at all, create an account on the
[Zulip community server](https://chat.zulip.org) and see what topics look
like there.
Topics are lightweight and do not need to be managed. Anyone writing to a
stream can and should [start topics](/help/start-a-new-topic) for new
conversations. "Old" topics naturally lose visibility over time, and do not
need to be deleted.
## Set up integrations
Zulip integrates directly with dozens of products, and hundreds more through
[Zapier](/integrations/doc/zapier) and [IFTTT](/integrations/doc/ifttt).
The [integrations page](/integrations) has instructions for integrating with
each product.
## Familiarize yourself with Zulips featureset
As the administrator of your Zulip organization, you'll be the initial
expert teaching other users how to use Zulip.
* [Review your settings](/help/review-your-settings), and skim the article
names here on the left sidebar.
* Learn the basic [keyboard shortcuts](/help/keyboard-shortcuts) (`n`, `r`, `c`, and `End`).
* Bonus: learn [Markdown message formatting](/help/format-your-message-using-markdown).
* If anything is confusing or feels missing, [contact
us](/help/contact-support)! We love hearing from users.
## Invite users and onboard your community
* [Delete any test messages](/help/edit-or-delete-a-message#delete-a-message-completely)
or [topics](/help/delete-a-topic) you want to delete.
* Configure
[allowed authentication methods](/help/configure-authentication-methods),
and [invite users](/help/invite-new-users).
* If you have an existing chat tool, make sure everyone knows that the
team is switching, and why. The team should commit to use Zulip
exclusively **for at least a week** to make an effective trial;
stragglers will result in everyone having a bad experience.
* If [community topic edits](/help/community-topic-edits) are enabled,
encourage a few people to help rename topics for the first few days, while
everyone is still getting used to the new conversation model.
## Bonus things to set up
* [Add custom profile fields](/help/add-custom-profile-fields).
- [Automatically linkify](/help/add-a-custom-linkification-filter)
issue numbers.
- [Write custom integrations](/api/integrations-overview)
for your teams workflow.
- If your users primarily speak a language other than English,
[set a default language for your organization](/help/change-the-default-language-for-your-organization).
- [Add custom emoji](/help/add-custom-emoji), at the very least for
your organization's logo.
- Link to your Zulip instance with a [nice badge](/help/linking-to-zulip).
- Send feedback to the Zulip development community! We love hearing
about problems (however minor) and feature ideas that could make
Zulip even better.