Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

docs: Change next planned major release to 3.0. 

After some discussion, everyone seems to agree that 3.0 is the more
appropriate version number for our next major release.  This updates
our documentation to reflect that we'll be using 3.0 as our next major
release.
This commit is contained in:
Tim Abbott 2020-06-24 16:25:14 -07:00
parent e0b725be63
commit e46bbf18eb
7 changed files with 44 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/overview/changelog.md
View File

@ -2,7 +2,7 @@
All notable changes to the Zulip server are documented in this file.
### 2.2.0 -- Unreleased
### 3.0 -- Unreleased
This section lists notable unreleased changes; it is generally updated
in bursts.
@ -38,7 +38,7 @@ in bursts.
changelog](https://zulip.com/api/changelog).
- Our primary official domain is now zulip.com, not zulipchat.com.
#### Upgrade notes for 2.2.0
#### Upgrade notes for 3.0
- Logged in users will be logged out during this one-time upgrade to
transition them to more secure session cookies.
@ -1744,7 +1744,7 @@ Zulip apps.
This section links to the upgrade notes from past releases, so you can
easily read them all when upgrading across multiple releases.
* [Upgrade notes for 2.2.0](#upgrade-notes-for-2-2-0)
* [Upgrade notes for 3.0](#upgrade-notes-for-3-0)
* [Upgrade notes for 2.1.5](#upgrade-notes-for-2-1-5)
* [Upgrade notes for 2.1.0](#upgrade-notes-for-2-1-0)
* [Upgrade notes for 2.0.0](#upgrade-notes-for-2-0-0)

2
docs/production/authentication-methods.md
View File

@ -146,7 +146,7 @@ IdP.
The above configuration is sufficient for Service Provider initialized
SSO, i.e. you can visit the Zulip webapp and click "Sign in with
{IdP}" and it'll correctly start the authentication flow. If you are
not hosting multiple organizations, with Zulip 2.2+, the above
not hosting multiple organizations, with Zulip 3.0+, the above
configuration is also sufficient for Identity Provider initiated SSO,
i.e. clicking a "Sign in to Zulip" button on the IdP's website can
correctly authenticate the user to Zulip.

4
docs/production/upgrade-or-modify.md
View File

@ -86,7 +86,7 @@ containing the changes planned for the next minor release
were a published release.
The `master` branch contains changes planned for the next major
release (E.g. 2.2.0); see our documentation on [running
release (E.g. 3.0); see our documentation on [running
master](#upgrading-to-master) before upgrading to it.
By default, this uses the main upstream Zulip server repository, but
@ -199,7 +199,7 @@ instructions for other supported platforms.
### Upgrading from Ubuntu 18.04 Bionic to 20.04 Focal
1. Upgrade your server to the latest Zulip release (at least 2.2.0,
1. Upgrade your server to the latest Zulip release (at least 3.0,
which adds support for Ubuntu Focal).
2. As the Zulip user, stop the Zulip server and run the following

2
templates/zerver/api/changelog.md
View File

@ -8,7 +8,7 @@ server versions is to check the `zulip_feature_level` parameter in the
`/register` and `/server_settings` responses to determine which of the
below features are supported.
## Changes in Zulip 2.2
## Changes in Zulip 3.0
**Feature level 21**

4
templates/zerver/help/change-a-users-role.md
View File

@ -15,9 +15,9 @@ there is at least one other owner in the organization (Consider
promoting a new owner or [deactivating the
organization](/help/deactivate-your-organization) instead).
**Changes** Organization owners were introduced in Zulip 2.2; users
**Changes** Organization owners were introduced in Zulip 3.0; users
that were marked as administrators in older Zulip instances are
automatically converted during the upgrade to Zulip 2.2 into owners
automatically converted during the upgrade to Zulip 3.0 into owners
(who have the same permissions as administrators did previously).
### Change a user's role

2
version.py
View File

@ -1,6 +1,6 @@
import os
ZULIP_VERSION = "2.2.dev+git"
ZULIP_VERSION = "3.0.dev+git"
# Add information on number of commits and commit hash to version, if available
zulip_git_version_file = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'zulip-git-version')
if os.path.exists(zulip_git_version_file):

68
zerver/openapi/zulip.yaml
View File

@ -493,7 +493,7 @@ paths:
The special values of `'newest'` and `'oldest'` are also supported
for anchoring the query at the most recent or oldest messages.
**Changes**: String values are new in Zulip 2.2 (feature level 1). The
**Changes**: String values are new in Zulip 3.0 (feature level 1). The
`first_unread` functionality was supported in Zulip 2.1.x
and older by not sending anchor and using use_first_unread_anchor.
@ -552,7 +552,7 @@ paths:
Whether to use the (computed by the server) first unread message
matching the narrow as the `anchor`. Mutually exclusive with `anchor`.
**Changes**: Deprecated in Zulip 2.2, replaced by
**Changes**: Deprecated in Zulip 3.0, replaced by
`anchor="first_unread"` instead.
schema:
type: boolean
@ -838,7 +838,7 @@ paths:
Whether to send breadcrumb message to the old thread to
notify users where the messages were moved to.
**Changes**: New in Zulip 2.2 (feature level 9).
**Changes**: New in Zulip 3.0 (feature level 9).
schema:
type: boolean
default: true
@ -849,7 +849,7 @@ paths:
Whether to send a notification message to the new thread to
notify users where the messages came from.
**Changes**: New in Zulip 2.2 (feature level 9).
**Changes**: New in Zulip 3.0 (feature level 9).
schema:
type: boolean
default: true
@ -1532,7 +1532,7 @@ paths:
You can also fetch details on [all users in the organization](/api/get-users).
*This endpoint is new in Zulip Server 2.2.*
*This endpoint is new in Zulip Server 3.0 (feature level 1).*
parameters:
- $ref: '#/components/parameters/UserId'
- $ref: '#/components/parameters/ClientGravatar'
@ -1637,7 +1637,7 @@ paths:
The owner role cannot be removed from the only organization owner.
**Changes**: New in Zulip 2.2 (feature level 8), replacing the previous
**Changes**: New in Zulip 3.0 (feature level 8), replacing the previous
pair of `is_admin` and `is_guest` boolean parameters.
schema:
type: integer
@ -1865,7 +1865,7 @@ paths:
for the user's avatar. Clients generally shouldn't need to use this;
most avatar URLs sent by Zulip will already end with `?v={avatar_version}`.
**Changes**: New in Zulip 2.2 (feature level 10). Previous
**Changes**: New in Zulip 3.0 (feature level 10). Previous
versions do not return this field.
example: 1
email:
@ -1889,14 +1889,14 @@ paths:
A boolean indicating if the requesting user is
an organization owner.
**Changes**: New in Zulip 2.2 (feature level 8).
**Changes**: New in Zulip 3.0 (feature level 8).
example: false
is_guest:
type: boolean
description: |
A boolean indicating if the requesting user is a guest.
**Changes**: New in Zulip 2.2 (feature level 10). Previous
**Changes**: New in Zulip 3.0 (feature level 10). Previous
versions do not return this field.
example: false
is_bot:
@ -1909,7 +1909,7 @@ paths:
description: |
A boolean specifying whether the user account has been deactivated.
**Changes**: New in Zulip 2.2 (feature level 10). Previous
**Changes**: New in Zulip 3.0 (feature level 10). Previous
versions do not return this field.
example: true
timezone:
@ -1917,7 +1917,7 @@ paths:
description: |
The time zone of the user.
**Changes**: New in Zulip 2.2 (feature level 10). Previous
**Changes**: New in Zulip 3.0 (feature level 10). Previous
versions do not return this field.
example: ""
date_joined:
@ -1925,7 +1925,7 @@ paths:
description: |
The time the user account was created.
**Changes**: New in Zulip 2.2 (feature level 10). Previous
**Changes**: New in Zulip 3.0 (feature level 10). Previous
versions do not return this field.
example: "2019-10-20T07:50:53.728864+00:00"
max_message_id:
@ -2252,7 +2252,7 @@ paths:
description: |
Whether only organization administrators can post to the stream.
**Changes**: Deprecated in Zulip 2.2 (feature level 1), use
**Changes**: Deprecated in Zulip 3.0 (feature level 1), use
`stream_post_policy` instead.
is_web_public:
type: boolean
@ -2272,7 +2272,7 @@ paths:
* 2 => Only administrators can post.
* 3 => Only new members can post.
**Changes**: New in Zulip 2.2, replacing the previous
**Changes**: New in Zulip 3.0, replacing the previous
`is_announcement_only` boolean.
message_retention_days:
type: integer
@ -2286,7 +2286,7 @@ paths:
level setting.
* `-1` encodes retaining messages in this stream forever.
**Changes**: New in Zulip 2.2 (feature level 17).
**Changes**: New in Zulip 3.0 (feature level 17).
history_public_to_subscribers:
type: boolean
description: |
@ -2662,7 +2662,7 @@ paths:
`GET {{ api_url }}/v1/users/{user_id}/subscriptions/{stream_id}`
**Changes**: New in Zulip 2.2 (feature level 11).
**Changes**: New in Zulip 3.0 (feature level 11).
parameters:
- $ref: '#/components/parameters/UserId'
example: 7
@ -2839,7 +2839,7 @@ paths:
The user ID of the user who uploaded the custom emoji.
Will be null if the uploader is unknown.
**Changes**: New in Zulip 2.2 (feature level 7). Previously
**Changes**: New in Zulip 3.0 (feature level 7). Previously
was accessible via and `author` object with an `id` field.
- example:
{
@ -3107,7 +3107,7 @@ paths:
Setting this to `true` will make presence dictionaries be keyed by
user_id instead of email.
**Changes**: New in Zulip 2.2 (Unstable with no feature level yet).
**Changes**: New in Zulip 3.0 (Unstable with no feature level yet).
schema:
type: boolean
default: false
@ -3143,7 +3143,7 @@ paths:
updated to process the new bulk format (with a
`message_ids`, rather than a singleton `message_id`).
Otherwise, the server will send `delete_message` events
in a loop. New in Zulip 2.2 (feature level 13). This
in a loop. New in Zulip 3.0 (feature level 13). This
capability is for backwards-compatibility; it will be
required in a future server release.
@ -3154,7 +3154,7 @@ paths:
`avatar_url` field in the `realm_user` at its sole discretion
to optimize network performance. This is an important optimization
in organizations with 10,000s of users.
New in Zulip 2.2 (feature level 18).
New in Zulip 3.0 (feature level 18).
schema:
type: object
example:
@ -3351,7 +3351,7 @@ paths:
feature or API change. See the [changelog](/api/changelog) for
details on what each feature level means.
**Changes**. New in Zulip 2.2. We recommend using an implied value
**Changes**. New in Zulip 3.0. We recommend using an implied value
of 0 for Zulip servers that do not send this field.
push_notifications_enabled:
type: boolean
@ -3773,7 +3773,7 @@ paths:
* 2 => Only administrators can post.
* 3 => Only new members can post.
**Changes**: New in Zulip 2.2, replacing the previous
**Changes**: New in Zulip 3.0, replacing the previous
`is_announcement_only` boolean.
message_retention_days:
type: integer
@ -3787,7 +3787,7 @@ paths:
level setting.
* `-1` encodes retaining messages in this stream forever.
**Changes**: New in Zulip 2.2 (feature level 17).
**Changes**: New in Zulip 3.0 (feature level 17).
history_public_to_subscribers:
type: boolean
description: |
@ -3812,7 +3812,7 @@ paths:
description: |
Whether the given stream is announcement only or not.
**Changes**: Deprecated in Zulip 2.2 (feature level 1), use
**Changes**: Deprecated in Zulip 3.0 (feature level 1), use
`stream_post_policy` instead.
is_default:
type: boolean
@ -3964,7 +3964,7 @@ paths:
description: |
Whether the stream is limited to announcements.
**Changes**: Deprecated in Zulip 2.2 (feature level 1), use
**Changes**: Deprecated in Zulip 3.0 (feature level 1), use
`stream_post_policy` instead.
schema:
type: boolean
@ -4032,7 +4032,7 @@ paths:
**Changes**: Before Zulip 2.0, this parameter accepted only a JSON-encoded
list of email addresses. Support for the email address-based format was
removed in Zulip 2.2 (feature level 11).
removed in Zulip 3.0 (feature level 11).
schema:
type: array
items:
@ -4511,7 +4511,7 @@ components:
description: |
The ID of the user who added the reaction.
**Changes**: New in Zulip 2.2 (feature level 2). The `user`
**Changes**: New in Zulip 3.0 (feature level 2). The `user`
object is deprecated and will be removed in the future.
user:
type: object
@ -4593,7 +4593,7 @@ components:
filters][linkification-filters] that match content in the
message's topic.)
**Changes**: New in Zulip 2.2 (feature level 1).
**Changes**: New in Zulip 3.0 (feature level 1).
Previously, this field was called `subject_links`;
clients are recommended to rename `subject_links`
to `topic_links` if present for compatibility with
@ -4675,7 +4675,7 @@ components:
A boolean specifying whether the user is an organization owner.
If true, is_admin will also be true.
**Changes**: New in Zulip 2.2 (feature level 8).
**Changes**: New in Zulip 3.0 (feature level 8).
bot_type:
type: integer
nullable: true
@ -4700,7 +4700,7 @@ components:
Will be null for legacy bots that do not have an owner.
**Changes**: New in Zulip 2.2 (feature level
**Changes**: New in Zulip 3.0 (feature level
1). In previous versions, there was a `bot_owner` field
containing the email address of the bot's owner.
is_active:
@ -5097,7 +5097,7 @@ components:
* 2 => Only administrators can post.
* 3 => Only new members can post.
**Changes**: New in Zulip 2.2, replacing the previous
**Changes**: New in Zulip 3.0, replacing the previous
`is_announcement_only` boolean.
schema:
type: integer
@ -5170,7 +5170,7 @@ components:
from the streams specified in the `subscriptions` parameter. If
not provided, then the requesting user/bot is subscribed.
**Changes**: The integer format is new in Zulip 2.2 (Feature level 9).
**Changes**: The integer format is new in Zulip 3.0 (Feature level 9).
schema:
type: array
items:
@ -5192,7 +5192,7 @@ components:
* `zulip_extra_emoji`: Special emoji included with Zulip. Exists to
namespace the `zulip` emoji.
**Changes**: In Zulip 2.2 (feature level 2), this become
**Changes**: In Zulip 3.0 (feature level 2), this become
optional for [custom emoji](/help/add-custom-emoji);
previously, this endpoint assumed `unicode_emoji` if this
parameter was not specified.
@ -5234,7 +5234,7 @@ components:
* "realm_default" => Return to the organization-level setting.
* "forever" => Retain messages forever.
**Changes**: New in Zulip 2.2 (feature level 17).
**Changes**: New in Zulip 3.0 (feature level 17).
schema:
oneOf:
- type: string