Skip to content

Commit 2a79f81

Browse files
authored
Merge branch 'main' into generators
2 parents b07f9ee + 33fa230 commit 2a79f81

File tree

2 files changed

+45
-45
lines changed

2 files changed

+45
-45
lines changed

guides/appendix/windows.md

Lines changed: 45 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,50 @@ To get started ensure the following dependencies are installed:
66
* Git - [https://git-scm.com/](https://git-scm.com/)
77
* Chrome - [https://www.google.com/chrome/](https://www.google.com/chrome/)
88

9+
## WSL 2
10+
11+
For the best experience developing Ember apps in Windows, we recommend using WSL 2.
12+
13+
Since build 20262 of Windows 10 [Windows Subsystem for Linux (WSL) 2](https://docs.microsoft.com/windows/wsl/install-win10)
14+
is available. WSL allows you to run a Linux system on your Windows computer that allows
15+
you to use some Linux tools and gives much better performance and file path resolution for
16+
developing Ember on Windows.
17+
18+
Once you have followed the [guide to install WSL 2](https://docs.microsoft.com/windows/wsl/install-win10)
19+
you can then install the latest Ubuntu from the Microsoft store (instructions are also
20+
included in the guide).
21+
22+
<div class="cta">
23+
<div class="cta-note">
24+
<div class="cta-note-body">
25+
<div class="cta-note-heading">Zoey says...</div>
26+
<div class="cta-note-message">
27+
Make sure that you aren't working in any folder under <code>/mnt/</code> as the performance isn't as good as working in your home directory (<em>'~'</em>) in WSL!
28+
</div>
29+
</div>
30+
<img src="/images/mascots/zoey.png" role="presentation" alt="">
31+
</div>
32+
</div>
33+
34+
You will need to make sure that you have Node.js installed in your WSL environment, if you haven't already done so you can follow [this guide](https://docs.microsoft.com/en-us/windows/nodejs/setup-on-wsl2).
35+
36+
Open your terminal on your WSL environment (for more information you might want to follow [this guide](https://devblogs.microsoft.com/commandline/a-guide-to-invoking-wsl/)) and then clone your Ember app repository.
37+
38+
```shell
39+
cd ~
40+
git clone your-repo
41+
```
42+
43+
you can now install your dependencies and start the Ember app:
44+
45+
```shell
46+
cd ~/your-repo
47+
npm i
48+
npm start
49+
```
50+
51+
IF you use VSCode, there is a useful plugin to make sure that it uses your WSL environment called ["Remote - WSL"](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). For more information you can [follow this tutorial](https://code.visualstudio.com/docs/remote/wsl-tutorial).
52+
953
### Performance
1054

1155
Although supported, Windows performance, at least by default, isn't as good as
@@ -75,46 +119,4 @@ as it decided to act on a package resulting in hard-to-debug race conditions.
75119
`npm` 3 is a nearly complete rewrite of `npm`, fixing both issues. Windows users of
76120
Ember CLI might want to make the switch to `npm` 3 to benefit from its
77121
flat module installation (solving most issues involving long path names) as well
78-
as its multi-stage installer.
79-
80-
### WSL 2
81-
82-
Since build 20262 of Windows 10 [Windows Subsystem for Linux (WSL) 2](https://docs.microsoft.com/windows/wsl/install-win10)
83-
is available. WSL allows you to run a Linux system on your Windows computer that allows
84-
you to use some Linux tools and should hopefully give us much better performance for
85-
developing Ember on Windows.
86-
87-
Once you have followed the [guide to install WSL 2](https://docs.microsoft.com/windows/wsl/install-win10)
88-
you can then install the latest Ubuntu from the Microsoft store (instructions are also
89-
included in the guide).
90-
91-
<div class="cta">
92-
<div class="cta-note">
93-
<div class="cta-note-body">
94-
<div class="cta-note-heading">Zoey says...</div>
95-
<div class="cta-note-message">
96-
Make sure that you aren't working in any folder under <code>/mnt/</code> as the performance isn't as good as working in your home directory (<em>'~'</em>) in WSL!
97-
</div>
98-
</div>
99-
<img src="/images/mascots/zoey.png" role="presentation" alt="">
100-
</div>
101-
</div>
102-
103-
You will need to make sure that you have Node.js installed in your WSL environment, if you haven't already done so you can follow [this guide](https://docs.microsoft.com/en-us/windows/nodejs/setup-on-wsl2).
104-
105-
Open your terminal on your WSL environment (for more information you might want to follow [this guide](https://devblogs.microsoft.com/commandline/a-guide-to-invoking-wsl/)) and then clone your Ember app repository.
106-
107-
```shell
108-
cd ~
109-
git clone your-repo
110-
```
111-
112-
you can now install your dependencies and start the Ember app:
113-
114-
```shell
115-
cd ~/your-repo
116-
npm i
117-
npm start
118-
```
119-
120-
IF you use VSCode, there is a useful plugin to make sure that it uses your WSL environment called ["Remote - WSL"](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). For more information you can [follow this tutorial](https://code.visualstudio.com/docs/remote/wsl-tutorial).
122+
as its multi-stage installer.

guides/writing-addons/in-repo-addons.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,8 @@ appropriate file extension for your addon stylesheet file.
3232
In order to compile HTMLBars templates that are part of your in-repo-addon,
3333
your `package.json` file will need to include following dependencies:
3434

35-
- `babel-plugin-htmlbars-inline-precompile`
3635
- `ember-cli-babel`
3736
- `ember-cli-htmlbars`
38-
- `ember-cli-htmlbars-inline-precompile`
3937

4038
(Use the same versions found in your Ember CLI Application's `package.json`)
4139

0 commit comments

Comments
 (0)