3397 Commits

Author SHA1 Message Date
Tim Abbott
15409c05e2 docs: Bump versions in upgrade page examples. 2025-02-28 17:12:25 -08:00
Tim Abbott
9508877fbc docs: Modernize PostgreSQL upgrade instructions. 2025-02-28 17:12:25 -08:00
Tim Abbott
8a44d77eda docs: Delete Trusty to Xenial upgrade documentation.
I don't believe there's anyone still running 2.0.x versions.
2025-02-28 17:12:24 -08:00
Tim Abbott
b9cbbbcb35 docs: Rewrite server configuration page.
- Restructure the introductory content to be more focused on the
  overview.

- The bottom content was a stale duplicate of the bottom of the
  installer page, dating from when this was a required step after
  running the installer.

- Most of the longer-form sections were duplicates of sections of
  either the installer page or the introductions of dedicated pages on
  the topic. Remove these in favor of new entries in the popular
  settings area.

- Mention storage as a popular setting to configure.

- Remove deleted Twitter integration from popular settings list.
2025-02-28 17:12:24 -08:00
Anders Kaseorg
d7556b4060 requirements: Migrate to uv.
https://docs.astral.sh/uv/

Signed-off-by: Anders Kaseorg <anders@zulip.com>
2025-02-24 22:29:24 -08:00
Lauryn Menard
b96d94f679 docs: Update sections for organization settings tab changes.
Updates help center, integration and contributor docs where for
the new subsections on the organization settings tab, which were
changed in #33605.

Previously, these settings were all in the "Other settings"
subsection for that organization settings tab.
2025-02-24 18:14:21 -08:00
Tim Abbott
1031a97d0c docs: Update changelog for changes in main. 2025-02-20 14:53:03 -08:00
Alya Abbott
18a1a1e8e3 docs: Tweak descriptions of Zoom app options. 2025-02-14 10:17:52 -08:00
Lauryn Menard
8561800676 video-calls: Add Zoom Serverto Server OAuth integration.
Adds a second Zoom integration that uses the Zoom Server to Server
OAuth app process. Only one of the two Zoom integrations can be
configured on a Zulip server.

Adds a cache for the access token from the Zoom server so that it
can be used by the server to create meetings for the approximate
duration of the access token

In the web-app compose box, if the user's delivery email does not
match a user on the configured Zoom account for the server to server
integration, then a compose box error banner will be shown when the
error response is received after clicking/selecting the video or
audio call button.

Also updates the production documentation for the both types of Zoom
integration apps (Server to Server and General). The General app
process for Zoom now requires unlisted apps to go through their
review process, which we now have documented.

Fixes #33117.
2025-02-13 16:35:43 -08:00
Alex Vandiver
adbdbee26b cache: Rename user_profile_cache_key to be more specific. 2025-02-13 12:40:53 -08:00
Mateusz Mandera
0a45a289f2 install: Add --agree-to-terms-of-service flag. 2025-02-13 09:49:28 -08:00
Alya Abbott
ea7cc614a5 contributor docs: Reorganize contributor guide.
- Offer more hand-holding at the start.
- Clean up dev environment setup steps.
- Move joining CZO later in the process.
- Move feedback section to feature suggestions page.
- Drop other non-coding info, as it exists elsewhere.
2025-02-12 12:58:10 -08:00
Alya Abbott
801bf0454f contributor docs: Consistently describe project hours and difficulty. 2025-02-11 09:55:34 -08:00
Tim Abbott
745a81b70b docs: Add a few new GSoC project ideas.
I expect to add a few more in the coming weeks.
2025-02-10 17:25:28 -08:00
Mateusz Mandera
0de58860dc install: Configure services during installation. 2025-02-05 17:47:28 -08:00
Greg Price
2ce4fad39f contributor docs: Update GSoC mobile project for 2025. 2025-02-05 13:25:09 -08:00
Alya Abbott
0430a4bd0a contributor docs: Add link to GSoC 2024 blog post. 2025-02-04 15:58:54 -08:00
Alya Abbott
b080ebb140 contributor docs: Drop outdated GSoC projects. 2025-02-04 14:35:02 -08:00
Alya Abbott
a4e8b97e28 contributor docs: Document policy for non-code attributions. 2025-02-03 16:50:05 -08:00
Niamh
9dfa477b7f docs: Add a missing word in mentoring guide. 2025-02-03 12:16:59 -08:00
Alya Abbott
3b727d2b51 contributor docs: Fix a nit.
"Conjugation" applies to verbs, not nouns.
2025-01-31 17:46:17 -08:00
Tim Abbott
948e01c8f6 docs: Document plurals better in i18n guide. 2025-01-31 14:32:47 -08:00
Tim Abbott
bd08c0b980 docs: Explain web app translations before server, and use those terms.
This seems good for prioritizing what is important first, and should
make it easier to add the Flutter app in the future.
2025-01-31 14:32:47 -08:00
Alya Abbott
e0cf9d33b8 contributor docs: Reorganize internationalization documentation.
Pull forward content that's actionable for contributors, and
organize it in terms of how it will be applied.
2025-01-31 14:32:47 -08:00
Mateusz Mandera
6d555b01d0 docs: Document the push notifications registration transfer flow. 2025-01-30 14:32:36 -08:00
Niloth P
68019cb48d integration-docs: Remove unused macros.
The `append-channel-name` and `append-topic` macros' instructions are
unnecessary as the topic and channel names are now part of the generated
URL.

The `git-webhook-url-branches` macro becomes equivalent to
`git-append-branches` with the auto-generation of the URL.
2025-01-30 11:59:38 -08:00
Alya Abbott
3dd3de3efa contributor docs: Describe how to handle follow-ups. 2025-01-24 15:02:18 -08:00
Steve Howell
aaa8279cb8 testing doc: Update common setup methods.
The names of helpers have evolved over time.

I add a few, and I remove `common_subscribe_to_streams`,
since most tests just want the simpler subscribe.

Note that `subscribe`, while not full stack, does
excercise `bulk_add_subscriptions`. So there is no
real danger of having unrealistic test data.

Almost all of our uses of `common_subscribe_to_streams`
are in test_subs.py, so it's already effectively
our policy to use subscribe in most cases. And
test_subs does more than a thorough job of actually
exercising the API.
2025-01-23 16:10:37 -08:00
Greg Price
9883e41436 docs: Clarify design-discussions as to #mobile-design vs. #design.
We have an increasing number of design discussions about mobile
these days (which is great), and that means I've started to
regularly point people to this page -- particularly the section
"Guidelines for code contributors" -- as part of pointing them to
the #mobile-design channel to ask a design question.

In that context it seems confusing that it only talks about #design
and not #mobile-design.  We do mention the latter elsewhere on the
page, but I still feel I have to explain the discrepancy when
pointing to this section.  Fix it here instead.

This introduces to our docs the concept of "a design channel",
meaning #design and #mobile-design and sometimes #zulip-terminal.
2025-01-22 16:16:33 -08:00
Greg Price
fa06616f71 docs: Pull out named links for channels in design-discussions page.
This helps keep the source a bit more readable; and we'll shortly
add another pair of occurrences of these.
2025-01-22 16:16:19 -08:00
Tim Abbott
84be984619 docs: Add documentation on using icons. 2025-01-22 12:54:19 -08:00
Alya Abbott
d4426f3bab contributor docs: Document how to add and modify icons. 2025-01-22 12:54:19 -08:00
Alex Vandiver
3ec896ebda nginx: Add an option which defaults loadbalancer requests to https.
In some cases, it is not possible to configure the load-balancer to
add an X-Forwarded-Proto header.  If Zulip is serving its traffic over
HTTP, it will rightly error out, since it cannot guarantee that its
response will be served over an encrypted connection.

Add a new `loadbalancer.rejects_http_requests` settings which serves
as a way for the operator to swear that the load-balancer will *never*
serve responses from Zulip over an unencrypted connection.  In most
cases, this is because the load-balancer is configured to have port 80
always serve an HTTP 301 redirect to the same URL over HTTPS.

Properly configuring the proxy to send `X-Forwarded-Proto` is always a
better solution than using this configuration parameter, so use of
this should be viewed as a last resort.
2025-01-22 12:25:42 -08:00
Alex Vandiver
d74e176cbe docs: Fix missing references. 2025-01-21 15:12:49 -08:00
Alex Vandiver
1e9099737d docs: Update changelog for 9.4 release. 2025-01-16 18:00:30 +00:00
Nehal Sharma
04f06a4588 integrations: Add support for BigBlueButton voice only calls.
We now allow users to create voice calls when their call provider is
BigBlueButton. This is done by creating a call where cameras are
disabled for all participants in the call -- a voice call, and making
only the call creator the moderator, so no one else can switch a voice
only call to a video call.

Also, we stop using the deprecated fields "attendeePW" and "moderatorPW"
in the Big Blue Button API, and use "role" instead.

The side effects are that now we only support BigBlueButton 2.4 and
above, and that only the call creator is a moderator and all other
joinees are viewers for all BigBlueButton calls.

Fixes: #26550.

Most of the code for the integration was written by Nehal.
Apoorva made the changes that resolve conflicts which were
introduced because of the `typed_endpoint` decorator.

With some documentation tweaks by tabbott.

Co-authored-by: Apoorva Pendse <apoorvavpendse@gmail.com>
2025-01-09 13:54:46 -08:00
Alya Abbott
34b7c6de2d help: Refresh email notifications help page.
Document more clearly when notifications are triggered.
2025-01-09 12:38:46 -08:00
Lauryn Menard
e882b95d2b help: Adjust links and text for "/help/channels-permissions".
Adjusts links and text to the help center article for revision
of channel permissions documentation, specifically in /docs,
/web, and /zerver directories.

The links in the /help and /templates/corporate directories
were updated when the documentation was revised.
2025-01-07 13:41:40 -08:00
Shubham Padia
333b3904b5 user_group_settings: Use user-group-x icon for deactivate button. 2025-01-06 09:48:28 -08:00
apoorvapendse
892afcbe98 setup_docs: Add command to terminate WSL2 environment.
This commit adds an alternative way to shutdown the
zulip WSL2 environment.
2025-01-04 17:29:27 -08:00
Greg Price
6c80d80ad3 docs: Update contributing/design-discussions for #mobile-design. 2025-01-02 15:48:57 -08:00
apoorvapendse
44f5f4e129 setup_docs: Update vagrant installation to support Ubuntu 24.04.
Update the Vagrant installation procedure, as Vagrant is no
longer available in the apt repository starting from Ubuntu 24.04

Fixes #32837.
2025-01-02 09:13:24 -08:00
Saubhagya Patel
faa9680fc8 docs: Update markdown.md for echo.ts module update.
This commit updates the "Markdown implementation"
documentation in the `markdown.md` file to reflect the
conversion of the `echo.js` module to TypeScript.
2024-12-30 09:43:29 -08:00
Saubhagya Patel
222c59507c docs: Update sending-messages.md for variable/function updates.
This commit updates the "Sending messages" documentation
in the `sending-messages.md` file to reflect the variable and
function updates, ensuring consistency with changes in the
codebase over time.
2024-12-30 09:43:29 -08:00
Anders Kaseorg
58822372d5 typos: Fix typos caught by typos and mwic.
Signed-off-by: Anders Kaseorg <anders@zulip.com>
2024-12-24 19:15:36 -08:00
Alex Vandiver
3eb501fa18 requirements: Require some swap space if installed on < 5GB RAM. 2024-12-22 06:52:06 -08:00
apoorvapendse
852fc42317 setup_docs: Fix wording for WSL2 python environment.
This is valid because the WSL2 python environment
has to be always activated manually.
2024-12-18 08:56:27 -08:00
apoorvapendse
d37f6c56be setup_docs: Put activation command in a code block for WSL.
This commit puts the activation command in a code block
instead of an inline code snippet.
2024-12-18 08:56:27 -08:00
Mateusz Mandera
94cc413016 docs: Renaming AzureAD to Entra ID, part two.
This is a follow-up to #32693, which missed a bunch of places due to
varying ways of typing Azure AD. (Azure AD, Azure Active Directory etc.)

In the diff there's an apparent inconsistency with renaming, in some
places renaming to just "Microsoft Entra ID" and in others
"Microsoft Entra ID (AzureAD)".
The idea is to add (AzureAD) in ordinary documentation, as it can help
clarity since many people still think of this as AzureAD, while sticking
with brevity and cleanliness of just using the official name in
marketing focused material.
2024-12-15 08:22:30 -08:00
Mateusz Mandera
81c2c0b328 docs: Finish renaming AzureAD to Entra ID.
Microsoft has been renaming AzureAD to Entra ID. Though both names still
seem to function, even if unofficially, so this mostly renames to `Entra
ID (AzureAD)` to reference both for clarity.
2024-12-12 17:48:54 -08:00