v5.5.0 - PR #199 from glenn2223

# 5.5.0 - 2022-07-09

### Added
- `liveSassCompile.settings.format[].savePathReplacementPairs` - Closes [#189](#187)
- You can now apply `savePath` and then key replacement (`savePathReplacementPairs`) to get to your desired save location - Closes [#184](#184), [#187](#187),

### Deprecated
- The new method for replacing segments in the save path is `savePathReplacementPairs`
  - `liveSassCompile.settings.format[].savePathSegmentKeys`
  - `liveSassCompile.settings.format[].savePathReplaceSegmentsWith`
- When SASS v2 is released these settings will be removed, adding deprecation warning now so it can be implemented sooner
  - `liveSassCompile.settings.format[].linefeed`
  - `liveSassCompile.settings.format[].indentType`
  - `liveSassCompile.settings.format[].indentWidth`

### Fixed
- Stopped output if not watching and working on a single SASS file
- The status bar now only updates once when working on many files. This means that the result shows the overall outcome, rather than the status of the last file

### Updated
- `sass` from `1.51.10` to `1.53.0`
  - Preserve location of trailing loud comments (`/* ... */`) instead of pushing the comment to the next line
  - Add support for calling `var()` with an empty second argument, such as `var(--side, )`
  - Fix a bug where `meta.load-css()` would sometimes resolve relative URLs incorrectly when called from a mixin using the legacy JS API
  - Other changes *(nothing user facing)*
- Various dev dependency updates *(nothing user facing)*

CHANGELOG.md

@@ -22,6 +22,33 @@ Types of changes
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [5.5.0] - 2022-07-09
+
+### Added
+- `liveSassCompile.settings.format[].savePathReplacementPairs` - Closes [#189](https://github.com/glenn2223/vscode-live-sass-compiler/issues/187)
+- You can now apply `savePath` and then key replacement (`savePathReplacementPairs`) to get to your desired save location - Closes [#184](https://github.com/glenn2223/vscode-live-sass-compiler/issues/184), [#187](https://github.com/glenn2223/vscode-live-sass-compiler/issues/187),
+
+### Deprecated
+- The new method for replacing segments in the save path is `savePathReplacementPairs`
+  - `liveSassCompile.settings.format[].savePathSegmentKeys`
+  - `liveSassCompile.settings.format[].savePathReplaceSegmentsWith`
+- When SASS v2 is released these settings will be removed, adding deprecation warning now so it can be implemented sooner
+  - `liveSassCompile.settings.format[].linefeed`
+  - `liveSassCompile.settings.format[].indentType`
+  - `liveSassCompile.settings.format[].indentWidth`
+
+### Fixed
+- Stopped output if not watching and working on a single SASS file
+- The status bar now only updates once when working on many files. This means that the result shows the overall outcome, rather than the status of the last file
+
+### Updated
+- `sass` from `1.51.10` to `1.53.0`
+  - Preserve location of trailing loud comments (`/* ... */`) instead of pushing the comment to the next line
+  - Add support for calling `var()` with an empty second argument, such as `var(--side, )`
+  - Fix a bug where `meta.load-css()` would sometimes resolve relative URLs incorrectly when called from a mixin using the legacy JS API
+  - Other changes *(nothing user facing)*
+- Various dev dependency updates *(nothing user facing)*
+
 ## [5.4.0] - 2022-05-19
 
 ### Added 
@@ -506,6 +533,7 @@ The new commands are:
 | 0.0.1 | 11.07.17 | Initial Preview Release with following key features. <br> – Live SASS & SCSS Compile. <br> – Customizable file location of exported CSS. <br> – Customizable exported CSS Style (`expanded`, `compact`, `compressed`, `nested`.)<br> – Quick Status bar control.<br> – Live Reload to browser (`Live Server` extension dependency). |
 
 
+[5.5.0]: https://github.com/glenn2223/vscode-live-sass-compiler/compare/v5.4.0...v5.5.0
 [5.4.0]: https://github.com/glenn2223/vscode-live-sass-compiler/compare/v5.3.1...v5.4.0
 [5.3.1]: https://github.com/glenn2223/vscode-live-sass-compiler/compare/v5.3.0...v5.3.1
 [5.3.0]: https://github.com/glenn2223/vscode-live-sass-compiler/compare/v5.2.0...v5.3.0

docs/faqs.md

@@ -1,9 +1,10 @@
 # FAQs
-
-## Q. I'm migrating from Ritwick Dey's extension, what do I need to know?
+Click a question to reveal its answer
 
 <details>
-<summary>Answer</summary>
+<summary>
+  <h2>I'm migrating from Ritwick Dey's extension, what do I need to know?</h2>
+</summary>
 
 Well, **lots of things**.
 
@@ -20,7 +21,7 @@ Here's some of the most important changes:
     - When `true` we will find a `.browserslistrc` file or `browserslist` in your `package.json`. No more duplicating settings!
   - `showOutputWindow` is now `showOutputWindowOn` and uses log values (`Debug`, `Error`, etc.). It's default log level is `Information` - at this level it will output the same information that the original extension does
 - Some settings are new!
-  - `formats[].savePathSegmentKeys` and `formats[].savePathReplaceSegmentsWith`: when used in combination you can choose to replace folder segments in the save path
+  - `formats[].savePathReplacementPairs`: replace segments in the output path
   - `formats[].linefeed`: control the line terminator used
   - `formats[].indentType`: control whether indents are spaces or tabs
   - `formats[].indentWidth`: control the width of the indentation
@@ -44,12 +45,10 @@ Here are some things you probably won't care about as much
 
 </details>
 
----
-
-## Q. How do I change the settings?
-
 <details>
-<summary>Answer</summary>
+<summary>
+  <h2>How do I change the settings?</h2>
+</summary>
 
 Create a `.vscode` folder in the root of your project. Inside the `.vscode` folder create a JSON file named `settings.json`.
 
@@ -82,25 +81,23 @@ Open the `settings.json` file and type following key-value pairs. *By the way, y
 
 </details>
 
----
-
-## Q. Why isn't it starting?
-
 <details>
-<summary>Answer</summary>
+<summary>
+  <h2>Why isn't it starting?</h2>
+</summary>
 
 If the extension doesn't activate (show up in the status bar), then it's most likely that you don't have any `.scss` or`.sass` files in your project.
-
+  
 Just create a SASS file, or open one, and the extension will activate
+
+Alternatively, if you're working with `.sass` files, you may not have the [SASS extension](https://marketplace.visualstudio.com/items?itemName=Syler.sass-indented) installed. Install it so VS Code can identify `.sass` files and activate the extension.
 
 </details>
 
----
-
-## Q. Why isn't it compiling my files?
-
 <details>
-<summary>Answers</summary>
+<summary>
+  <h2>Why are my files not compiling?</h2>
+</summary>
 
 A common issue is incorrectly configured glob patterns used in the include/exclude settings. You can check your glob patterns [here](https://globster.xyz/) (*be aware that this site doesn't match all [picomatch expressions](https://github.com/micromatch/picomatch#library-comparisons)*).
 
@@ -118,13 +115,10 @@ Still no luck?
 
 </details>
 
----
-
-
-## Q. So... about multi-root workspaces?
-
 <details>
-<summary>Answers</summary>
+<summary>
+  <h2>So... about multi-root workspaces?</h2>
+</summary>
 
 ### What is it?