@@ -0,0 +1,31 @@
1+# Installing Elm
2+
3+There are two ways to install Elm:
4+
5+- **Installers** for Mac or Windows
6+- **Instructions** for [Mac][mac] or [Linux][lin]
7+
8+The code in this directory builds the Mac and Windows installers, which are available [here](https://guide.elm-lang.org/install.html).
9+
10+It is definitely valuable to read the install instructions even if you are not using them though! They reveal how installers actually work.
11+
12+[mac]: https://github.com/elm/compiler/blob/master/installers/mac/README.md
13+[lin]: https://github.com/elm/compiler/blob/master/installers/linux/README.md
14+
15+
16+<br/>
17+
18+## Installing Multiple Versions
19+
20+The secret is that Elm is just a single executable file. If you are developing a project in `~/Desktop/project/` you can download this file into that directory and run commands like `~/Desktop/project/elm make src/Main.elm` or `./elm make src/Main.elm`. You just run the local copy of the executable file!
21+
22+The instructions for [Mac][mac] and [Linux][lin] explain how to do this in more detail. You can follow the same steps on Windows, but you need to do each step by hand. (E.g. download the file through your browser rather than with a terminal command.)
23+
24+
25+<br/>
26+
27+## Uninstall
28+
29+- [Mac](https://github.com/elm/compiler/blob/master/installers/mac/README.md#uninstall)
30+- [Linux](https://github.com/elm/compiler/blob/master/installers/linux/README.md#uninstall)
31+- [Windows](https://github.com/elm/compiler/blob/master/installers/win/README.md)