docs: Update architecture overview introduction.

This doc needs significant further updates, but this at least makes
clear Zulip supports organizations well past 1000 users and adds some
links.
This commit is contained in:
Tim Abbott
2019-05-20 11:35:47 -07:00
parent 6b39d6004e
commit f140228528

View File

@@ -37,26 +37,25 @@ application.
Usage assumptions and concepts Usage assumptions and concepts
------------------------------ ------------------------------
Zulip is a real-time web-based chat application meant for companies and Zulip is a real-time web-based chat application meant for companies
similar groups ranging in size from a small team to more than a thousand and similar groups ranging in size from a small team to 10,000s of
users. It features real-time notifications, message persistence and users. It features real-time notifications, message persistence and
search, public group conversations (*streams*), private streams, search, public group conversations (*streams*), private streams,
private one-on-one and group conversations, inline image previews, team private one-on-one and group conversations, inline image previews,
presence/buddy lists, a rich API, Markdown message support, and numerous team presence/buddy lists, a rich API, Markdown message support, and
integrations with other services. The maintainer team aims to support numerous integrations with other services. It supports dedicated iOS,
users who connect to Zulip using dedicated iOS, Android, Linux, Windows, Android, Linux, Windows, and macOS clients, as well as people using
and macOS clients, as well as people using modern web browsers or modern web browsers, cross-protocol chat tools, and dedicated [Zulip
dedicated Zulip API clients. API](https://zulipchat.com/apoi) clients (e.g. bots).
A server can host multiple Zulip *realms* (organizations) at the same A server can host multiple Zulip *realms* (organizations) at the same
domain, each of which is a private chamber with its own users, domain, each of which is a private chamber with its own users,
streams, customizations, and so on. This means that one person might streams, customizations, and so on. This means that one person might
be a user of multiple Zulip realms. The administrators of a realm can be a user of multiple Zulip realms. The administrators of an
choose whether to allow anyone to register an account and join, or organization have a great deal of control over who can register an
only allow people who have been invited, or restrict registrations to account, what permissions new users have, etc. For more on security
members of particular groups (using email domain names or corporate considerations and options, see [the security model
single-sign-on login for verification). For more on security section](../production/security-model.html) and the [Zulip Help Center](https://zulipchat.com/help).
considerations, see [the security model section](../production/security-model.html).
The Zulip "All messages" screen is like a chronologically ordered inbox; The Zulip "All messages" screen is like a chronologically ordered inbox;
it displays messages, starting at the oldest message that the user it displays messages, starting at the oldest message that the user
@@ -296,8 +295,9 @@ component of the Zulip server (e.g.
## Glossary ## Glossary
This section gives names for some of the elements in the Zulip UI used This section gives names for some of the elements in the Zulip UI used
in Zulip development conversations. Contributions to extend this list in Zulip development conversations. In general, our goal is to
are welcome! minimize the set of terminology listed here by giving elements
self-explanatory names.
* **chevron**: A small downward-facing arrow next to a message's * **chevron**: A small downward-facing arrow next to a message's
timestamp, offering contextual options, e.g., "Reply", "Mute [this timestamp, offering contextual options, e.g., "Reply", "Mute [this