Add codeActionsOnSave to docs

docs/languages/javascript.md

@@ -213,6 +213,58 @@ Organize imports can also be automatically when you save a JavaScript file by se
     "source.organizeImports": true
 }
 ```
+## Code Actions on Save
+
+The  `editor.codeActionsOnSave` setting lets you configure a set of Code Actions that are run when a file is saved. For example, you can enable organize imports on save by setting:
+```json
+// On save, run both fixAll and organizeImports source actions
+"editor.codeActionsOnSave": {
+    "source.fixAll": true,
+    "source.organizeImports": true,
+}
+```
+You can also enable or disable which Code Actions are run on save per language using a language specific setting:
+```json
+"[javascript]": {
+    "editor.codeActionsOnSave": {
+        "source.organizeImports": true
+    }
+}
+```
+Here are some source actions:
+
+* `"organizeImports"` -  Enables organize imports on save.
+* `"fixAll"` - Auto Fix on Save computes all possible fixes in one round (for all providers including ESLint).
+* `"fixAll.eslint"` -  Auto Fix only for ESLint.
+* `"addMissingImports"` - Adds all missing imports on save.
+
+The TSLint extension already uses `source.fixAll` Code Action kind to implement fix all and auto fix on save.
+
+You can also set `editor.codeActionsOnSave` to an array of Code Actions to execute in order. You can use this to guarantee that a specific Code Action is always run before or after another one that may conflict with it.
+The following `editor.codeActionsOnSave` will always run Organize Imports followed by Fix All once organize imports finishes:
+```json
+"editor.codeActionsOnSave": [
+    "source.organizeImports",
+    "source.fixAll"
+]
+```
+Note: `editor.codeActionsOnSave` supports both object and array configs in settings.
+
+Examples:
+
+Selective behaviour for different source actions:
+```json
+ "editor.codeActionsOnSave": {
+        "source.fixAll": true,
+        "source.fixAll.eslint": false
+    }
+```
+Add all missing imports on save:
+```json
+"editor.codeActionsOnSave": [
+    "source.addMissingImports"
+]
+```
 
 ## Code suggestions
 

docs/languages/typescript.md

@@ -245,7 +245,58 @@ Organize imports can also be automatically when you save a TypeScript file by se
     "source.organizeImports": true
 }
 ```
+## Code Actions on Save
 
+The  `editor.codeActionsOnSave` setting lets you configure a set of Code Actions that are run when a file is saved. For example, you can enable organize imports on save by setting:
+```json
+// On save, run both fixAll and organizeImports source actions
+"editor.codeActionsOnSave": {
+    "source.fixAll": true,
+    "source.organizeImports": true,
+}
+```
+You can also enable or disable which Code Actions are run on save per language using a language specific setting:
+```json
+"[typescript]": {
+    "editor.codeActionsOnSave": {
+        "source.organizeImports": true
+    }
+}
+```
+Here are some source actions:
+
+* `"organizeImports"` -  Enables organize imports on save.
+* `"fixAll"` - Auto Fix on Save computes all possible fixes in one round (for all providers including ESLint).
+* `"fixAll.eslint"` -  Auto Fix only for ESLint.
+* `"addMissingImports"` - Adds all missing imports on save.
+
+The TSLint extension already uses `source.fixAll` Code Action kind to implement fix all and auto fix on save.
+
+You can also set `editor.codeActionsOnSave` to an array of Code Actions to execute in order. You can use this to guarantee that a specific Code Action is always run before or after another one that may conflict with it.
+The following `editor.codeActionsOnSave` will always run Organize Imports followed by Fix All once organize imports finishes:
+```json
+"editor.codeActionsOnSave": [
+    "source.organizeImports",
+    "source.fixAll"
+]
+```
+Note: `editor.codeActionsOnSave` supports both object and array configs in settings.
+
+Examples:
+
+Selective behaviour for different source actions:
+```json
+ "editor.codeActionsOnSave": {
+        "source.fixAll": true,
+        "source.fixAll.eslint": false
+    }
+```
+Add all missing imports on save:
+```json
+"editor.codeActionsOnSave": [
+    "source.addMissingImports"
+]
+```
 ## Code suggestions
 
 VS Code automatically suggests some common code simplifications such as converting a chain of `.then` calls on a promise to use `async` and `await`