README.md in shakapacker-7.2.3 vs README.md in shakapacker-7.3.0.beta.1
- old
+ new
@@ -701,32 +701,13 @@
```
#### Sass
```bash
-yarn add sass-loader
+yarn add sass sass-loader
```
-You will also need to install [Dart Sass](https://github.com/sass/dart-sass), [Node Sass](https://github.com/sass/node-sass) or [Sass Embedded](https://github.com/sass/embedded-host-node) to pick the implementation to use. sass-loader will automatically pick an implementation based on installed packages.
-
-Please refer to [sass-loader documentation](https://www.npmjs.com/package/sass-loader) and individual packages repos for more information on all the options.
-
-##### Dart Sass
-```bash
-yarn add sass
-```
-
-##### Node Sass
-```bash
-yarn add node-sass
-```
-
-##### Sass Embedded
-```bash
-yarn add sass-embedded
-```
-
#### Less
```bash
yarn add less less-loader
```
@@ -896,9 +877,13 @@
```js
// Note it's relative to parent directory i.e. app/assets
import 'stylesheets/main'
import 'images/rails.png'
```
+
+Assets put in these folders will have their directory stripped just like with the `source_path`. For example:
+
+A file in `app/assets/images/image.svg` with `additional_paths: ['app/assets']` will result in `static/images/image.svg`
**Note:** Please be careful when adding paths here otherwise it will make the compilation slow, consider adding specific paths instead of the whole parent directory if you just need to reference one or two modules
**Also note:** While importing assets living outside your `source_path` defined in shakapacker.yml (like, for instance, assets under `app/assets`) from within your packs using _relative_ paths like `import '../../assets/javascripts/file.js'` will work in development, Shakapacker won't recompile the bundle in production unless a file that lives in one of it's watched paths has changed (check out `Shakapacker::MtimeStrategy#latest_modified_timestamp` or `Shakapacker::DigestStrategy#watched_files_digest` depending on strategy configured by `compiler_strategy` option in `shakapacker.yml`). That's why you'd need to add `app/assets` to the additional_paths as stated above and use `import 'javascripts/file.js'` instead.