zulip/docs/dev-overview.md

# Development environment options

Zulip offers a wide range of options for how to install the
development environment:

* [Detailed tutorial for Vagrant development environment](dev-env-first-time-contributors.html).  Recommended for first-time contributors.
* [Brief installation instructions for Vagrant development environment](brief-install-vagrant-dev.html)
* [Installing on Ubuntu 14.04 Trusty or 16.04 Xenial directly](install-ubuntu-without-vagrant-dev.html) (convenient but more work to maintain/uninstall).
* [Installing manually on other UNIX platforms](install-generic-unix-dev.html)
* [Using Docker (experimental)](install-docker-dev.html)
* [Using the Development Environment](using-dev-environment.html)
* [Testing](testing.html)

If you have a slow network connection, you should probably avoid
installing Vagrant (which is large) and either install
[directly](install-ubuntu-without-vagrant-dev.html) or use [the manual
install process](install-generic-unix-dev.html) instead.
docs: Clean up duplicated content in development overview. 2016-08-25 07:13:12 +02:00			`# Development environment options`
Move development installations instructions to a separate file. This will make the core README.md file cleaner. 2015-11-04 05:57:54 +01:00
docs: Clean up duplicated content in development overview. 2016-08-25 07:13:12 +02:00			`Zulip offers a wide range of options for how to install the`
			`development environment:`
Move development installations instructions to a separate file. This will make the core README.md file cleaner. 2015-11-04 05:57:54 +01:00
docs: Clean up duplicated content in development overview. 2016-08-25 07:13:12 +02:00			`* [Detailed tutorial for Vagrant development environment](dev-env-first-time-contributors.html). Recommended for first-time contributors.`
			`* [Brief installation instructions for Vagrant development environment](brief-install-vagrant-dev.html)`
			`* [Installing on Ubuntu 14.04 Trusty or 16.04 Xenial directly](install-ubuntu-without-vagrant-dev.html) (convenient but more work to maintain/uninstall).`
			`* [Installing manually on other UNIX platforms](install-generic-unix-dev.html)`
			`* [Using Docker (experimental)](install-docker-dev.html)`
			`* [Using the Development Environment](using-dev-environment.html)`
			`* [Testing](testing.html)`
Improve first-time contributor docs. Fixes #747. Fixes #748. This updates README.dev.md to include clear, step-by-step instructions for setting up the Zulip dev environment Windows 10, OS X El Capitan, Ubuntu 14.04 Trusty, and Ubuntu 16.04 Xenial. It is aimed at first-time contributors. I tested these instructions multiple times on each of the target systems. Also added is a "trobleshooting and common errors" section which documents the most common errors contributors are likely to encounter during setup and how to fix them. Improvements based on feedback from @timabbott. - Fixes whitespace issues so linter will pass. - Updates memory requirement. - Re-orders so operating systems are listed alphabetically. - Updates headings to be clearer. - Updates and adds ToC entries for clarity. - Adds screen shot of Zulip dev environment running in browser. - Adds details about using dev environment, including about logging. - Misc other minor changes for clarity. - Adds a stub for docs/logging.md - Adds details about configuring Cygwin for native symlinks. 2016-05-05 01:16:31 +02:00
doc: Recommend avoiding Vagrant install on slow connections. Per #1508, the manual install process is better for the developer environment on slow connections. 2016-08-15 04:24:10 +02:00			`If you have a slow network connection, you should probably avoid`
docs: Clean up duplicated content in development overview. 2016-08-25 07:13:12 +02:00			`installing Vagrant (which is large) and either install`
			`[directly](install-ubuntu-without-vagrant-dev.html) or use [the manual`
			`install process](install-generic-unix-dev.html) instead.`