Skip to content
This repository was archived by the owner on Dec 1, 2019. It is now read-only.

Commit 2975dec

Browse files
committed
docs: more about performance issues
1 parent 7f74bba commit 2975dec

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

README.md

+11-8
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,17 @@
99
npm install awesome-typescript-loader --save-dev
1010
```
1111

12+
## Performance issues
13+
14+
Please note that ATL works **the same way as a TypeScript compiler** as much as possible. So please be careful with your `files`/`exclude`/`include` sections.
15+
16+
**ADVICE**: Typically you want your `files` section to include only entry points.
17+
18+
**ADVICE**: The loader works faster if you use `isolatedModules` or `forceIsolatedModules` options.
19+
20+
The world is changing, other solutions are evolving and ATL may work **slower**
21+
for [some workloads](https://github.com/s-panferov/awesome-typescript-loader/issues/497). Feel free to try [`ts-loader`](https://github.com/TypeStrong/ts-loader) with [`HappyPack` ](https://github.com/amireh/happypack) or [`thread-loader`](https://webpack.js.org/loaders/thread-loader/) and [hard-source-webpack-plugin](https://github.com/mzgoddard/hard-source-webpack-plugin).
22+
1223
## Differences between [`ts-loader`](https://github.com/TypeStrong/ts-loader)
1324

1425
`awesome-typescript-loader` loader was created mostly to speed-up compilation in my own projects.
@@ -102,14 +113,6 @@ resolve: {
102113
}
103114
```
104115

105-
## Performance issues
106-
107-
Please note that ATL works **the same way as a TypeScript compiler** as much as possible. So please be careful with your `files`/`exclude`/`include` sections.
108-
109-
**ADVICE**: Typically you want your `files` section to include only entry points.
110-
111-
**ADVICE**: The loader works faster if you use `isolatedModules` or `forceIsolatedModules` options.
112-
113116
## Loader options
114117

115118
### silent *(boolean) (default=false)*

0 commit comments

Comments
 (0)