From 0bf65c1ad9c0bb4f53c5b63950a2856806e8ecae Mon Sep 17 00:00:00 2001
From: Simon Holthausen <simon.holthausen@accso.de>
Date: Mon, 18 Jan 2021 11:33:11 +0100
Subject: [PATCH] (doc) add info about when options are ignored

#764
---
 packages/svelte-vscode/README.md    | 18 +++++++++++++++---
 packages/svelte-vscode/package.json | 16 ++++++++--------
 2 files changed, 23 insertions(+), 11 deletions(-)

diff --git a/packages/svelte-vscode/README.md b/packages/svelte-vscode/README.md
index 29edf58c2..5ec40bd82 100644
--- a/packages/svelte-vscode/README.md
+++ b/packages/svelte-vscode/README.md
@@ -204,35 +204,47 @@ Svelte compiler warning codes to ignore or to treat as errors. Example: { 'css-u
 
 ##### `svelte.plugin.svelte.format.enable`
 
-Enable formatting for Svelte (includes css & js) using [prettier-plugin-svelte](https://github.com/sveltejs/prettier-plugin-svelte). You can set some formatting options through this extension. They will be ignored if there's a `.prettierrc` configuration file. _Default_: `true`
+Enable formatting for Svelte (includes css & js) using [prettier-plugin-svelte](https://github.com/sveltejs/prettier-plugin-svelte). _Default_: `true`
+
+You can set some formatting options through this extension. They will be ignored if there's any kind of configuration file, for example a `.prettierrc` file. Read more about Prettier's configuration file [here](https://prettier.io/docs/en/configuration.html).
 
 ##### `svelte.plugin.svelte.format.config.svelteSortOrder`
 
 Format: join the keys `options`, `scripts`, `markup`, `styles` with a `-` in the order you want. _Default_: `options-scripts-markup-styles`
 
+This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file.
+
 ##### `svelte.plugin.svelte.format.config.svelteStrictMode`
 
 More strict HTML syntax. _Default_: `false`
 
+This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file.
+
 ##### `svelte.plugin.svelte.format.config.svelteAllowShorthand`
 
 Option to enable/disable component attribute shorthand if attribute name and expression are the same. _Default_: `true`
 
+This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file.
+
 ##### `svelte.plugin.svelte.format.config.svelteBracketNewLine`
 
 Put the `>` of a multiline element on a new line. _Default_: `true`
 
+This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file.
+
 ##### `svelte.plugin.svelte.format.config.svelteIndentScriptAndStyle`
 
 Whether or not to indent code inside `<script>` and `<style>` tags. _Default_: `true`
 
+This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file.
+
 ##### `svelte.plugin.svelte.format.config.printWidth`
 
-Maximum line width after which code is tried to be broken up. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead. _Default_: `80`
+Maximum line width after which code is tried to be broken up. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead. This option is also ignored if there's any kind of configuration file, for example a `.prettierrc` file. _Default_: `80`
 
 ##### `svelte.plugin.svelte.format.config.singleQuote`
 
-Use single quotes instead of double quotes, where possible. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead. _Default_: `false`
+Use single quotes instead of double quotes, where possible. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead. This option is also ignored if there's any kind of configuration file, for example a `.prettierrc` file. _Default_: `false`
 
 ##### `svelte.plugin.svelte.hover.enable`
 
diff --git a/packages/svelte-vscode/package.json b/packages/svelte-vscode/package.json
index c30d29f62..e5c70e87f 100644
--- a/packages/svelte-vscode/package.json
+++ b/packages/svelte-vscode/package.json
@@ -261,49 +261,49 @@
                     "type": "boolean",
                     "default": true,
                     "title": "Svelte: Format",
-                    "description": "Enable formatting for Svelte (includes css & js). You can set some formatting options through this extension. They will be ignored if there's a `.prettierrc` configuration file."
+                    "description": "Enable formatting for Svelte (includes css & js). You can set some formatting options through this extension. They will be ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.format.config.svelteSortOrder": {
                     "type": "string",
                     "default": "options-scripts-markup-styles",
                     "title": "Svelte Format: Sort Order",
-                    "description": "Format: join the keys `options`, `scripts`, `markup`, `styles` with a - in the order you want"
+                    "description": "Format: join the keys `options`, `scripts`, `markup`, `styles` with a - in the order you want. This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.format.config.svelteStrictMode": {
                     "type": "boolean",
                     "default": false,
                     "title": "Svelte Format: Strict Mode",
-                    "description": "More strict HTML syntax"
+                    "description": "More strict HTML syntax. This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.format.config.svelteAllowShorthand": {
                     "type": "boolean",
                     "default": true,
                     "title": "Svelte Format: Allow Shorthand",
-                    "description": "Option to enable/disable component attribute shorthand if attribute name and expression are the same"
+                    "description": "Option to enable/disable component attribute shorthand if attribute name and expression are the same. This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.format.config.svelteBracketNewLine": {
                     "type": "boolean",
                     "default": true,
                     "title": "Svelte Format: Bracket New Line",
-                    "description": "Put the `>` of a multiline element on a new line"
+                    "description": "Put the `>` of a multiline element on a new line. This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.format.config.svelteIndentScriptAndStyle": {
                     "type": "boolean",
                     "default": true,
                     "title": "Svelte Format: Indent Script And Style",
-                    "description": "Whether or not to indent code inside `<script>` and `<style>` tags"
+                    "description": "Whether or not to indent code inside `<script>` and `<style>` tags. This option is ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.format.config.printWidth": {
                     "type": "number",
                     "default": 80,
                     "title": "Svelte Format: Print Width",
-                    "description": "Maximum line width after which code is tried to be broken up. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead."
+                    "description": "Maximum line width after which code is tried to be broken up. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead. This option is also ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.format.config.singleQuote": {
                     "type": "boolean",
                     "default": false,
                     "title": "Svelte Format: Quotes",
-                    "description": "Use single quotes instead of double quotes, where possible. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead."
+                    "description": "Use single quotes instead of double quotes, where possible. This is a Prettier core option. If you have the Prettier extension installed, this option is ignored and the corresponding option of that extension is used instead. This option is also ignored if there's any kind of configuration file, for example a `.prettierrc` file."
                 },
                 "svelte.plugin.svelte.completions.enable": {
                     "type": "boolean",