From fc7d305791fc46932b8dd25eceb1f7f7c6bdfa9e Mon Sep 17 00:00:00 2001 From: Tim Abbott Date: Fri, 15 Nov 2024 15:08:56 -0800 Subject: [PATCH] docs: Improve opening for recommended setup page. --- docs/development/setup-recommended.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/development/setup-recommended.md b/docs/development/setup-recommended.md index 14e5f49d07..6b28f52e08 100644 --- a/docs/development/setup-recommended.md +++ b/docs/development/setup-recommended.md @@ -5,9 +5,15 @@ Zulip development environment on Windows, macOS, and Linux. The recommended method for installing the Zulip development environment is to use WSL 2 on Windows, and Vagrant with Docker on macOS and Linux. -This method uses the Windows Subsystem for Linux or creates a Linux container -(for macOS and Linux) inside which the Zulip server and all related -services will run. + +All of these recommended methods work by creating a container or VM +for the Zulip server and related services, with the Git repository +containing your source code mounted inside it. This strategy allows +the environment to be as reliable and portable as possible. The +specific technologies (Vagrant/Docker and WSL 2) were chosen based on +what technologies have been most reliable through our experience +supporting the thousands of people who've set up the Zulip development +environment. Contents: