zulip/docs/development/setup
Alex Vandiver 26189578c6 docs: Rework schema migrations guide around the online-deploy model.
Most of what makes a Zulip migration tricky to write follows from
how Zulip Cloud deploys: staging and production share a database,
staging deploys first and runs the migration against the shared
DB, production deploys some time later, and Django processes
restart in a rolling fashion. Together these mean migrations must
be safe for the previous release's code to keep running against,
and that staging-time problems are also live production problems.

The previous version of this page didn't describe any of that,
and as a result didn't motivate most of the rules contributors
need to follow. Rework the page around the deploy model so each
rule traces back to a property of how migrations actually run on
Cloud.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-28 15:59:32 +08:00
..
install-docker.md setup_docs: Use the usermod command for docker. 2026-02-17 21:12:56 -05:00
shared-vagrant-errors.md setup_docs: Extract common vagrant errors to a shared file. 2025-05-20 10:53:21 -07:00
unix-troubleshoot.md setup_docs: Extract common unix errors to a shared file. 2025-05-20 10:53:21 -07:00
vagrant-halt.md requirements: Migrate to uv. 2025-02-24 22:29:24 -08:00
vagrant-rebuild.md docs: Add comma to all uses of "e.g." in contributor docs. 2024-07-05 15:36:24 -07:00
vagrant-resume.md requirements: Migrate to uv. 2025-02-24 22:29:24 -08:00
vagrant-ssh.md requirements: Migrate to uv. 2025-02-24 22:29:24 -08:00
vagrant-up.md docs: Update CZO links from stream to channel in docs and comments. 2024-06-11 10:44:31 -07:00
vagrant-update.md docs: Update CZO links from stream to channel in docs and comments. 2024-06-11 10:44:31 -07:00
vscode-vagrant.md docs: Fix missing references. 2025-01-21 15:12:49 -08:00
winvm-troubleshoot.md setup_docs: Extract common Windows VM errors to a shared file. 2025-05-20 10:53:21 -07:00
wsl-rebuild.md docs: Rework schema migrations guide around the online-deploy model. 2026-05-28 15:59:32 +08:00
wsl-troubleshoot.md setup_docs: Add troubleshooting steps for WSL2. 2025-05-20 10:53:21 -07:00