Update readme

Author: micantoine

README.md

@@ -546,10 +546,33 @@ Pass an object of the following properties
 | `parseStyleTag` | `{Boolean}` | `true` | Enable parsing on style tag |
 | `useAsDefaultScoping` | `{Boolean}` | `false` | Replace svelte scoping globally |
 
+**`getLocalIdent`**
+
+Customize the creation of the classname instead of relying on the built-in function.
+
+```ts
+function getLocalIdent(
+  context: {
+    context: string, // the context path
+    resourcePath: string, // path + filename
+  },
+  localIdentName: {
+    template: string, // the template rule
+    interpolatedName: string, // the built-in generated classname
+  },
+  className: string, // the classname string
+  content: { 
+    markup: string, // the markup content
+    style: string,  // the style content
+  }
+): string {
+  return `your_generated_classname`;
+}
+```
 
 **`hashSeeder`**
 
-Set the resource content of `[hash]` and `[contenthash]`.
+Set the source to create the hash from (when using `[hash]` / `[contenthash]`).
 
 The list of available keys are:
 
@@ -588,30 +611,6 @@ preprocess: [
 </style>
 ```
 
-**`getLocalIdent`**
-
-Customize the creation of the classname instead of relying on the built-in function.
-
-```ts
-function getLocalIdent(
-  context: {
-    context: string, // the context path
-    resourcePath: string, // path + filename
-  },
-  localIdentName: {
-    template: string, // the template rule
-    interpolatedName: string, // the built-in generated classname
-  },
-  className: string, // the classname string
-  content: { 
-    markup: string, // the markup content
-    style: string,  // the style content
-  }
-): string {
-  return `your_generated_classname`;
-}
-```
-
 **`includeAttributes`**
 
 Add other attributes than `class` to be parsed by the preprocesser
@@ -700,6 +699,7 @@ Inspired by [webpack interpolateName](https://github.com/webpack/loader-utils#in
 
 Globally replace the default svelte scoping by the cssModules scoping. As a result, the `module` attribute to `<style>` becomes unnecessary.
 
+
 ```js
 // Preprocess config
 ...
@@ -725,6 +725,24 @@ preprocess: [
   .title-erYt1 { color: blue }
 </style>
 ```
+
+**Beware**   
+The enabled option will applied cssModules scoping to all imported Svelte files, even the ones coming from `node_modules`. When using a third party library, make sure the compiled version is being imported. In the case of a raw svelte file, its styling may be broken.
+
+To prevent any scoping conflict, it is recommended to associate the option `useAsDefaultScoping` with `includePaths`.
+
+```js
+// Preprocess config
+...
+preprocess: [
+  cssModules([
+    useAsDefaultScoping: true,
+    includePaths: ['./src'],
+  ]),
+],
+...
+```
+
 ## Migrating from v1
 If you want to migrate an existing project to `v2` keeping the approach of the 1st version, follow the steps below:
 
@@ -768,7 +786,7 @@ export default {
 }
 ```
 
-*Svelte Component using `<style>`*
+*Svelte Component*
 
 ```html
 <style module>
@@ -781,7 +799,7 @@ export default {
   .body {
     flex: 1 0 0;
   }
-  button {
+  .modal button {
     background-color: white;
   }
   .cancel {
@@ -801,32 +819,6 @@ export default {
 </section>
 ```
 
-***OR** Svelte Component importing external stylesheet*
-
-```css
-/** style.module.css */
-.modal {
-  position: fixed;
-}
-...
-```
-```html
-<script>
-  import style from './style.module.css';
-</script>
-
-<section class={style.modal}>
-  <header class={style.wrapper}>My Modal Title</header>
-  <div class="{style.body} {style.wrapper}">
-    <p>Lorem ipsum dolor sit, amet consectetur.</p>
-  </div>
-  <footer class={style.wrapper}>
-    <button>Ok</button>
-    <button class={style.cancel}>Cancel</button>
-  </footer>
-</section>
-```
-
 *Final html code generated by svelte*
 
 ```html
@@ -840,7 +832,7 @@ export default {
   ._1HPUBXtzNG {
     flex: 1 0 0;
   }
-  button {
+  ._329TyLUs9c button {
     background-color: white;
   }
   ._1xhJxRwWs7 {