diff options
| author | jenkins-bot <jenkins-bot@gerrit.wikimedia.org> | 2023-07-19 16:40:09 +0000 |
|---|---|---|
| committer | Gerrit Code Review <gerrit@wikimedia.org> | 2023-07-19 16:40:09 +0000 |
| commit | f8bec356018783e45e95f9d8cb6b13305ac60491 (patch) | |
| tree | f5b7b4a60211d09467c7dd43981d6c2bc6a34cc7 /DEVELOPERS.md | |
| parent | 527f0d01916c6baa12a9d61513a5b5227ebcdbc2 (diff) | |
| parent | f7d3b3586d807352f0a921c334888a70b3d6ebd0 (diff) | |
| download | mediawikicore-f8bec356018783e45e95f9d8cb6b13305ac60491.tar.gz mediawikicore-f8bec356018783e45e95f9d8cb6b13305ac60491.zip | |
Merge "DEVELOPERS.md: mention `git clone` and WSL"
Diffstat (limited to 'DEVELOPERS.md')
| -rw-r--r-- | DEVELOPERS.md | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/DEVELOPERS.md b/DEVELOPERS.md index 7d477200a256..e965570c95c4 100644 --- a/DEVELOPERS.md +++ b/DEVELOPERS.md @@ -41,7 +41,17 @@ You'll need to have Docker installed: [dc-binaries]: https://docs.docker.com/engine/install/binaries/ [dc-non-root]: https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user -### 2. Prepare `.env` file +**Windows users**: + +We recommend [configuring Docker to use the Windows Subsystem for Linux (WSL)](https://docs.docker.com/desktop/wsl/#best-practices). This will result in performance improvements. + +### 2. Download MediaWiki files + +Download the latest MediaWiki files to your computer. One way to download the latest alpha version of MediaWiki is to [install git](https://git-scm.com/), open a shell, navigate to the directory where you want to save the files, then type `git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki`. + +Optional: If you plan to submit patches to this repository, you will probably want to [create a Gerrit account](https://wikitech.wikimedia.org/wiki/Help:Create_a_Wikimedia_developer_account), then type `git remote set-url origin ssh://YOUR-GERRIT-USERNAME-HERE@gerrit.wikimedia.org:29418/mediawiki/core`, replacing YOUR-GERRIT-USERNAME-HERE with your Gerrit username. Please see the official [MediaWiki Gerrit tutorial](https://www.mediawiki.org/wiki/Gerrit/Tutorial) for more information. + +### 3. Prepare `.env` file Using a text editor, create a `.env` file in the root of the MediaWiki core repository, and copy these contents into that file: @@ -83,7 +93,7 @@ services: - "host.docker.internal:host-gateway" ``` -### 3. Create the environment +### 4. Create the environment * Start the containers: ```sh |