Commit Graph

3152 Commits

Author SHA1 Message Date
Lauryn Menard 04e2728cb0 documentation: Revise uses of "e.g.," followed by a colon. 2024-07-09 13:41:44 -07:00
Lauryn Menard 32b2eb5f47 documentation: Modify cases of "[a-zA-Z] e\.g\.," for readability. 2024-07-09 13:41:44 -07:00
Lauryn Menard 7e7e6b7ba9 integration-docs: Clarify use of event-filtering-additional-feature.
Using an if block when {!event-filtering-additional-feature.md!}
is used implied that we plan to have this in all webhook doc .md
files.

But, it actually makes sense to only use this macro when the
webhook integration actually supports event filtering.
2024-07-08 13:51:50 -07:00
Lauryn Menard 62d452f983 docs: Add comma to all uses of "e.g." in contributor docs. 2024-07-05 15:36:24 -07:00
Tim Abbott a3feecac62 docs: Add mock_template documentation to docs.
Previously, this content was only available in an error message, and
provided less context.
2024-06-27 11:58:59 -07:00
Prakhar Pratyush c10ef38b32 docs: Add subsystem doc for 'Onboarding Steps'.
Fixes part of #30043.
2024-06-18 09:39:50 -07:00
Prakhar Pratyush 0d59ff8c96 docs: Remove 'Hotspots' subsystem doc.
We no longer have 'Hotspots' to introduce users
to important UI elements.

We now use one time banners for it.
2024-06-18 09:39:50 -07:00
Sayam Samal dc7c514960 docs: Update #narrow links from stream->channel in hashchange-system.md. 2024-06-11 10:44:31 -07:00
Sayam Samal a7772f86a2 docs: Update CZO links from stream to channel in docs and comments.
Updates all the https://chat.zulip.org/#narrow/stream/ links in the
docs and comments to use the new /channel/ path. All these links are
for documentation/reference purposes only and thus, can be bulk-updated.

This commit is a part of the effort to rename stream to channel.
2024-06-11 10:44:31 -07:00
Jason 55d6f809ba docs: Improve STARTTLS / SSL documentation for Django email settings.
Django has some somewhat archaic variable names for configuring SMTP
that are misleading for users not familiar with Django.  Be more
explicit about the correct configuration for both implicit and
explicit TLS.

Co-authored-by: Alex Vandiver <alexmv@zulip.com>
2024-06-05 09:19:31 -07:00
Tim Abbott 6c67f92656 docs: Update changelog with changes since 8.x. 2024-06-04 15:37:05 -07:00
Alex Vandiver 09e9c75ec6 analytics: Remove `active_users` and `active_users_log` metrics.
Both of these are inaccurate, not currently used anywhere, and have
been superseded by the `active_users_audit` metric.
2024-06-03 12:35:35 -07:00
Alex Vandiver 230040caa9 puppet: Remove check_postgresql_backup.
We have replaced this monitoring with the black-box wal-g monitoring,
which is more accurate.
2024-05-24 11:27:59 -07:00
Alex Vandiver 2218de0399 management: Disable Sentry for management commands run interactively.
This adds `--automated` and `--no-automated` flags to all Zulip
management commands, whose default is based on if STDIN is a TTY.
This enables cron jobs and supervisor commands to continue to report
to Sentry, and manually-run commands (when reporting to Sentry does
not provide value, since the user can see them) to not.

Note that this only applies to Zulip commands -- core Django
commands (e.g. `./manage.py`) do not grow support for `--automated`
and will always report exceptions to Sentry.

`manage.py` subcommands in the `upgrade` and `restart-server` paths
are marked as `--automated`, since those may be run semi-unattended,
and they are useful to log to Sentry.
2024-05-24 10:30:16 -07:00
Alex Vandiver 5c2fd1de5a docs: Update Django links to our current version. 2024-05-24 10:18:37 -07:00
Aman Agrawal 1728a2c057 setup-recommended: Make user choose `osxfs` earlier to avoid failure.
Since the docker macOS setup doesn't work without this, it makes
sense for it to be just part of the setup instead of a thing
they fix after running into failure.
2024-05-20 22:46:22 -07:00
Anders Kaseorg b545abe1e2 typos: Fix typos caught by mwic.
Signed-off-by: Anders Kaseorg <anders@zulip.com>
2024-05-20 13:55:00 -07:00
Lauryn Menard 48df3d87e1 docs: Update non-language specific `docs/translating/` to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/translating` files to use channel instead of stream, except
for guides for specific languages as those should be updated by
the translation teams themselves.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard fdafda6e3a docs: Update `docs/contributing/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/contributing` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard 24e5e03d3f docs: Update `docs/development/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/development` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard db918bd78f docs: Update `docs/documentation/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/documentation` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard 0d175174b5 docs: Update `docs/outreach/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/outreach` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard 80511ea8ba docs: Update `docs/overview/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/overview` files to use channel instead of stream, except for
the changelog file.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard e05a3b3ecc docs: Update `docs/tutorials/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/tutorials` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard 99f129fb99 docs: Update `docs/testing/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/testing` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard 76b0025091 docs: Update `docs/subsystems/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/subsystems` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Lauryn Menard 42efea4e19 docs: Update `docs/production/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/production` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
evykassirer 96c9950115 composebox_typeahead: Convert module to typescript. 2024-05-16 14:53:26 -07:00
Bedo Khaled ed5e0fa141 docs: Remove manual flush memcached advice.
Co-authored-by: Tim Abbott <tabbott@zulip.com>
2024-05-15 17:32:34 -07:00
mk0904 f54605e290 Updated 'Private messages' to 'Direct messages' in the translation style guides 2024-05-15 14:52:26 -07:00
roanster007 0a7c0ea326 refactor: Relocate screenshots scripts to new tools/screenshots dir.
This commit relocates all the scripts in the tools directory which
are used for auto-generating screenshots to the new
tools/screenshots directory to avoid cluttering the tools/ root.
2024-05-14 16:17:44 -07:00
Alya Abbott c1a5b47f41 docs: Add updating /history to release checklist. 2024-05-09 12:40:21 -07:00
Alex Vandiver 55c2ad82df version: Update version and changelog following 8.4 release. 2024-05-09 19:07:58 +00:00
Alex Vandiver a7022bdfec docs: Update for wal-g not being required for replication. 2024-05-07 18:01:07 -07:00
Alex Vandiver 4e15a3969a docs: Document PostgreSQL multiple database host failover.
Added in bd82c6edf9, this is based on libpq's functionality[^1].

[^1]: https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-MULTIPLE-HOSTS
2024-05-07 17:28:10 -07:00
Alex Vandiver 73b760d829 docs: Move warm-standby replication into postgresql.md. 2024-05-07 17:28:10 -07:00
Tim Abbott 7db916fe66 docs: Fix a couple typos in pull request guide. 2024-05-06 12:47:50 -07:00
Prakhar Pratyush 422f5c4e1a help: Rename unarchive_stream management command to unarchive_channel. 2024-05-06 11:18:45 -07:00
Mateusz Mandera d544a41125 integrations: Rename stream->channel in integrations.md doc. 2024-05-06 09:07:57 -07:00
Mateusz Mandera 3c4ab345d0 webhooks: Rename append-stream-name.md->append-channel-name.md. 2024-05-06 09:07:57 -07:00
Mateusz Mandera 5c9f3cd08c webhooks: Rename create-stream.md to create-channel.md. 2024-05-06 09:07:57 -07:00
Alya Abbott a27fae16df contributor docs: Improve article on submitting a pull request.
- Give more guidance on how to think about PRs.
- Structure article as series of steps.
- Link to other pages to avoid duplicating content.
2024-05-04 23:57:12 -07:00
Alya Abbott 7c90544d14 contributor docs: Reorganize content on pull request docs. 2024-05-04 23:57:12 -07:00
Lauryn Menard 14ede84921 help: Update include markdown files for stream to channel rename. 2024-05-03 13:05:57 -07:00
Lauryn Menard 4908f1c5dc help: Rename and redirect stream-notifications for channel. 2024-05-03 12:55:39 -07:00
Aman Agrawal 7f131b880d billing: Document how to test different billing states. 2024-05-02 18:31:23 -07:00
Alya Abbott a302278987 contributor docs: Extend help center writing style documentation. 2024-05-02 13:37:44 -07:00
Prakhar Pratyush b17a006bf0 data_import: Remove gitter data import tool.
Gitter broke their older API as part of being integrated
into Matrix.

Their announcement blog says:
"Anything left using the Gitter APIs will need to be
updated to use the Matrix API"

This commit drops the legacy Gitter import tool and
we plan to build a new one for Matrix in future.
2024-05-02 13:25:25 -07:00
Lauryn Menard 8e953d9896 streams-settings-overlay: Update hash for stream to channel rename.
Updates the base hash for the streams setting overlay to be
"channels" instead of "streams".

Because there are Welcome Bot and Notification Bot messages that
would have been sent with the "/#streams" hash, we will need to
support parsing those overlay hashes as an alias for "/#channels"
permanently.

Part of the stream to channels rename project.
2024-04-30 14:44:12 -07:00
Alya Abbott 480bceae98 docs: Add introduction to video call providers doc.
Also explicitly document the Jitsi integration.
2024-04-29 18:14:40 -07:00
CIC4DA 3745e44963 navbar: Change the user list menu (narrow) to user-list.svg.
Fixes: zulip#28756
In this commit, we are changing the user list menu icon(narrow screen) from triple-users to user-list.
2024-04-24 17:37:38 -07:00
Tim Abbott 2c62152a8b left-sidebar: Rename "All direct messages" => "Direct message feed".
This aligns with the new naming scheme for other left sidebar
elements.
2024-04-17 12:42:21 -07:00
nimishmedatwal 1594011b67 left_sidebar: Rename All messages to Global Feed.
Fixes part of #27802.
2024-04-17 12:42:21 -07:00
Alex Vandiver 5654d051f7 worker: Split into separate files.
This makes each worker faster to start up.
2024-04-16 23:00:02 -07:00
Mateusz Mandera bd00337776 docs: Document new create_guests_without_streams SCIM option.
Documents the little functionality added in
c9ca4e68e5.
2024-04-15 11:16:59 -07:00
Prakhar Pratyush bc0325922e commands: Add 'skip-delay' option to send_zulip_update_announcements.
This commit adds a 'skip-delay' option to the
'send_zulip_update_announcements' management command.

It will be useful for self-hosted servers after 9.0 upgrade to
avoid the 24 hour delay to receive update messages after group
DM is sent to the admins.

One can run the management command with the --skip-delay flag
to immediately send the update messages.
2024-04-11 16:13:42 -07:00
Sayam Samal 27c85af6d9 message_controls: Remove view message source icon.
With this commit, if a user cannot edit or move his own message,
we no longer show the view message source icon.
2024-04-11 15:57:24 -07:00
Alex Vandiver 44c4b93f6e docs: Improve PostgreSQL documentation.
This removes a bunch of out-of-date documentation which is better
addressed outside of Zulip, and provides more details on running a
PostgreSQL server on a separate host.
2024-04-04 16:50:08 -07:00
Alex Vandiver 7187146422 install: Move PUPPET_CLASSES env var to --puppet-classes argument.
`--no-init-db` is used to silence the need for `--hostname` and
`--email` arguments; it is a proxy for "this is not a frontend host."
We would ideally like to use `has_class` to know if the user's
provided puppet classes are include an `app_frontend`, and thus
`--hostname` and `--email` are required -- but doing that requires
several other steps, and we would like this feedback to be immediate.

We make the presence of `--puppet-classes` equivalent to
`--no-init-db`, since nearly every configuration with
`--puppet-classes` does not install both a database and a frontend,
which is what is required to initialize a database.
2024-04-04 16:49:43 -07:00
Alex Vandiver a69e690122 puppet: Split out a zulip::profile::standalone_nodb class. 2024-04-04 16:48:58 -07:00
Alex Vandiver 65f1f83dac docs: Factor out PostgreSQL support matrix. 2024-04-04 16:48:58 -07:00
Ajay Singh dc80f29b8a
docs: Fix typo. 2024-04-04 10:51:37 -07:00
Anders Kaseorg 9e7bf865cd docs: Update current PostgreSQL version.
Signed-off-by: Anders Kaseorg <anders@zulip.com>
2024-04-01 16:14:01 -07:00
Anders Kaseorg 70914b0475 Remove support for Ubuntu 20.04 and Debian 11.
Signed-off-by: Anders Kaseorg <andersk@mit.edu>
2024-04-01 13:27:39 -07:00
Anders Kaseorg e535c96e40 Upgrade development environment to Ubuntu 22.04.
Signed-off-by: Anders Kaseorg <andersk@mit.edu>
2024-04-01 13:27:39 -07:00
evykassirer c7b12c996c typeahead: Convert module to typescript.
This contains two more complex changes:

- The default versions of sorter and matcher assume that ItemType is a
string. But the Typeahead class works on a generic ItemType and I'm
not aware of a way to assert that this function is only called for
typeaheads with string items. For `matcher`, we can assert that the
items are strings. `sorter` is now a required option instead of an
optional one that could fall back to the default.

- `element` can be either an `input` element or a `contenteditable`
`div`. We distinguish between them using `.is("[contenteditable]"))`
but TypeScript doesn't understand that. So we replaced `this.$element`
with `this.input_element` where `input_element` is an object with the
`$element` and also a `type` specifying which type of element it is
(input or contenteditable).
2024-03-30 10:41:38 -07:00
Anders Kaseorg 807a4428f6 compose_validate: Remove autosubscribe feature.
This was only used in the undocumented narrow_stream mode, and relied
on a deprecated synchronous XHR request.

Signed-off-by: Anders Kaseorg <anders@zulip.com>
2024-03-28 09:06:48 -07:00
nimishmedatwal 35c5231fe6 left-sidebar: Change recent conversation icon.
Fixes #29180
2024-03-26 12:55:34 -07:00
Eklavya Sharma 876366c6a7 docs: fix pronoun use in hindi translation guide.
Recommend the use of formal second-person pronouns in the Hindi
translation guide.
2024-03-26 09:08:09 -07:00
Alya Abbott 2514093688 docs and help: Update text of no-content mobile notifications.
Documentation follow-up to d9c5eb1280.
2024-03-22 18:16:24 -07:00
Robert Dyer eb2f1b4788 docs: Upgrade development environment page to use synced tabs.
This greatly reduces how much content for other platforms a reader has
to scroll past in order to get the development environment set up.
2024-03-22 16:54:57 -07:00
Robert Dyer 40bab84e8f docs: Fix some outdated links from development environment guide. 2024-03-22 16:54:57 -07:00
Alex Vandiver 23504308fb puppet: Install the same version of postgres-client as the server.
We require a `pg_dump` whose version matches the version of the server
we are configured against (see 3a8b4b0205).  Installing the latest
`postgresql-client` does not guarantee that we have such a binary
present.
2024-03-21 12:34:34 -07:00
afeefuddin 6f81fe1b5b info_overlay: Convert module to TypeScript. 2024-03-21 09:00:33 -07:00
tnmkr e1b101ceec docs: Fix incorrect function typo in events system. 2024-03-20 09:32:44 -07:00
Eklavya Sharma fb0697f266 docs: Fix typos in the Hindi translation guide. 2024-03-20 09:15:21 -07:00
Aditya Bajaj 8c5d333cde docs: Update broken edX reference links
Change edX's GitHub links to point to their new
organisation 'openedx' and change 'readthedocs.io'
links to 'docs.openedx.org'

Fixes #29332
2024-03-20 09:14:19 -07:00
Bedo Khaled 55dcdf8f01 docs: Change "restart" to "flush" command. 2024-03-20 09:13:38 -07:00
Alex Vandiver 1e5421276f version: Update version and changelog following 8.3 release. 2024-03-19 22:31:25 +00:00
Joydeep Bhattacharjee 2842945e6d ts: Replace all occurance of widgetize.js with widgetize.ts. 2024-03-19 12:12:23 -07:00
Alex Vandiver c129b1779f wal-g: Add support for incremental backups.
This only defaults to on for local-disk backups, since they are more
disk-size-sensitive, and local accesses are quite cheap compared to
loading multiple incremental backups from S3.
2024-03-19 09:58:58 -07:00
Alex Vandiver d726f87035 puppet: Remove backups cron job if they are no longer enabled. 2024-03-19 09:58:58 -07:00
Alex Vandiver 44ff1c24df wal-g: Provide a to-local-disk backup option. 2024-03-19 09:58:58 -07:00
Alex Vandiver 6fc3357a88 docs: Mention concurrency and storage class S3 backup settings. 2024-03-19 09:58:58 -07:00
Alex Vandiver d24fec702f docs: Indent code blocks which are part of bulleted lists.
This makes the subsequent bullet resume its numbering correctly.
2024-03-19 09:58:58 -07:00
Robert Dyer 32c8d89eeb docs: Cleanup setup-recommended.md.
For consistency, using `console` instead of `bash` to show commands to run, and dropping the name "christie" from examples.
2024-03-15 17:37:34 -07:00
Robert Dyer e367718283 docs: Refactor setup-recommended into includable files. 2024-03-15 17:37:34 -07:00
Robert Dyer 4d337cfc0d docs: Add dependency on sphinx_design.
Adds a dependency on "sphinx_design" for the docs system.  Allows
supporting tabs inside the developer documentatoin.  This is a
preparation commit for later refactoring of the OS-specific setup
documentation.
2024-03-15 17:37:34 -07:00
Alex Vandiver c13e3dee24 katex: Replace subprocess call with minimal external service.
Replace a separate call to subprocess, starting `node` from scratch,
with an optional standalone node Express service which performs the
rendering.  In benchmarking, this reduces the overhead of a KaTeX call
from 120ms to 2.8ms.  This is notable because enough calls to KaTeX in
a single message would previously time out the whole message
rendering.

The service is optional because he majority of deployments do not use
enough LaTeX to merit the additional memory usage (60Mb).

Fixes: #17425.
2024-03-15 15:34:12 -07:00
Bedo Khaled 2d61f22f8f docs: Clarify statement about optimization in major endpoints section.
Co-authored-by: Greg Price <greg@zulip.com>
2024-03-14 12:49:52 -07:00
evykassirer 03ec788a91 typeahead: Move module to web/src. 2024-03-11 09:56:18 -07:00
Jerry Yang 8a257d59e1 docs: Fix typo in screenshot and gif software tutorial.
Remove the redundant closing bracket in the Gifski link.
2024-03-11 09:26:08 -07:00
Alya Abbott 6eefd07c81 docs: Add plan sign-up to mobile notifications sign-up instructions. 2024-03-05 14:55:24 -08:00
afeefuddin 72681c2d5a hotspots: Convert module to TypeScript. 2024-03-04 18:17:34 -08:00
Anders Kaseorg 066ea3ebf9 install: Support Ubuntu 24.04.
Signed-off-by: Anders Kaseorg <anders@zulip.com>
2024-03-01 17:38:08 -08:00
Tim Abbott c1269f1038 docs: Better document backup/export tool tradeoffs.
- More consistent export/import vs backup bullets at the top.

- Remove misleading documentation regarding the `zulip_org_id` reuse
  problems. This documentation was written for Zulip 2.1.0 in
  c6fe6cf0a4 and largely made obsolete
  in d800ac33a0 (Zulip 5.0).

- Light editing for readability/crispness.

Fixes #28925.
2024-03-01 16:17:20 -08:00
Tim Abbott c0e88ad0ea docs: Fix broken Markdown links from recent reorganization.
Introduced in 2b95068406.
2024-02-29 18:11:55 -08:00
Bedo Khaled 75fa932489
docs: Fix a typo in architecture overview. 2024-02-26 08:22:37 -08:00
Alex Vandiver 8673f87907 puppet: Allow enabling "stats sizes" in memcached. 2024-02-23 13:32:04 -08:00
Alya Abbott 77ab7d810e docs: Move installation troubleshooting section to troubleshooting.md. 2024-02-20 22:26:11 -08:00