Improve README

Author: jhnns

README.md

@@ -13,16 +13,16 @@ Starting with `1.0.0`, the sass-loader requires [node-sass](https://github.com/s
 [Documentation: Using loaders](http://webpack.github.io/docs/using-loaders.html)
 
 ``` javascript
-var css = require("!raw!sass!./file.scss");
+var css = require('!raw!sass!./file.scss');
 // => returns compiled css code from file.scss, resolves imports
-var css = require("!css!sass!./file.scss");
+var css = require('!css!sass!./file.scss');
 // => returns compiled css code from file.scss, resolves imports and url(...)s
 ```
 
 Use in tandem with the [`style-loader`](https://github.com/webpack/style-loader) to add the css rules to your document:
 
 ``` javascript
-require("!style!css!sass!./file.scss");
+require('!style!css!sass!./file.scss');
 ```
 
 ### Apply via webpack config
@@ -35,14 +35,14 @@ module.exports = {
     loaders: [
       {
         test: /\.scss$/,
-        loader: "style!css!sass"
+        loader: 'style!css!sass'
       }
     ]
   }
 };
 ```
 
-Then you only need to write: `require("./file.scss")`.
+Then you only need to write: `require('./file.scss')`.
 
 ### Sass options
 
@@ -56,9 +56,9 @@ module.exports = {
         test: /\.scss$/,
         loader: "style!css!sass?outputStyle=expanded&" +
           "includePaths[]=" +
-            (path.resolve(__dirname, "./bower_components")) + "&" +
+            encodeURIComponent(path.resolve(__dirname, "./some-folder")) + "&" +
           "includePaths[]=" +
-            (path.resolve(__dirname, "./node_modules"))
+            encodeURIComponent(path.resolve(__dirname, "./another-folder"))
       }
     ]
   }
@@ -69,7 +69,7 @@ See [node-sass](https://github.com/andrew/node-sass) for all available options.
 
 ### Imports
 
-webpack provides an [advanced mechanism to resolve files](http://webpack.github.io/docs/resolving.html). The sass-loader uses node-sass' custom importer feature to pass all queries to the webpack resolving engine. Thus you can import your sass-modules from `node_modules`. Just prepend them with a `~` which tells webpack to look-up the [`modulesDirectories`](http://webpack.github.io/docs/configuration.html#resolve-modulesdirectories)
+webpack provides an [advanced mechanism to resolve files](http://webpack.github.io/docs/resolving.html). The sass-loader uses node-sass' custom importer feature to pass all queries to the webpack resolving engine. Thus you can import your sass-modules from `node_modules`. Just prepend them with a `~` which tells webpack to look-up the [`modulesDirectories`](http://webpack.github.io/docs/configuration.html#resolve-modulesdirectories).
 
 ```css
 @import "~bootstrap/less/bootstrap";
@@ -95,9 +95,14 @@ module.exports = {
 };
 ```
 
-### Importing across language styles
+### Problems with `url(...)`
 
-Importing a file written in the other language style, like importing a `.sass` file from a `.scss` file, requires the file extension to be set explicitly. If no extension is specified, the extension is inherited from the importing file.
+Since Sass/[libsass](https://github.com/sass/libsass) does not provide [url rewriting](https://github.com/sass/libsass/issues/532), all linked assets must be relative to the output.
+
+- If you're just generating CSS without passing it to the css-loader, it must be relative to your web root.
+- If you pass the generated CSS on to the css-loader, all urls must be relative to the entry-file (e.g. `main.scss`).
+
+Library authors usually provide a variable to modify the asset path. [bootstrap-sass](https://github.com/twbs/bootstrap-sass) for example has an `$icon-font-path`. Check out [this example](https://github.com/jtangelder/sass-loader/tree/master/test/bootstrapSass).
 
 ## Source maps