generator-code 1.6.10 → 1.6.13

package/generators/app/templates/ext-command-ts/package.json

@@ -1,48 +1,48 @@
 {
   "name": <%- JSON.stringify(name) %>,
-	"displayName": <%- JSON.stringify(displayName) %>,
-	"description": <%- JSON.stringify(description) %>,
-	"version": "0.0.1",
-	"engines": {
-		"vscode": <%- JSON.stringify(vsCodeEngine) %>
-	},
-	"categories": [
-		"Other"
-	],
-	"activationEvents": [
-        <%- JSON.stringify(`onCommand:${name}.helloWorld`) %>
-	],
-	"main": "./out/extension.js",<% if (insiders) { %>
-	"enabledApiProposals": [],<% } %>
-	"contributes": {
-		"commands": [
-			{
-				"command": <%- JSON.stringify(`${name}.helloWorld`) %>,
-				"title": "Hello World"
-			}
-		]
-	},
-	"scripts": {
-		"vscode:prepublish": "<%= pkgManager %> run compile",
-		"compile": "tsc -p ./",
-		"watch": "tsc -watch -p ./",
-		"pretest": "<%= pkgManager %> run compile && <%= pkgManager %> run lint",
-		"lint": "eslint src --ext ts",
-		"test": "node ./out/test/runTest.js"<% if (insiders) { %>,
-		"update-proposed-api": "vscode-dts dev"<% } %>
-	},
-	"devDependencies": {
-		<%- dep("@types/vscode") %>,
-		<%- dep("@types/glob") %>,
-		<%- dep("@types/mocha") %>,
-		<%- dep("@types/node") %>,
-		<%- dep("@typescript-eslint/eslint-plugin") %>,
-		<%- dep("@typescript-eslint/parser") %>,
-		<%- dep("eslint") %>,
-		<%- dep("glob") %>,
-		<%- dep("mocha") %>,
-		<%- dep("typescript") %>,
-		<%- dep("@vscode/test-electron") %><% if (insiders) { %>,
-		<%- dep("vscode-dts") %><% } %>
-	}
+  "displayName": <%- JSON.stringify(displayName) %>,
+  "description": <%- JSON.stringify(description) %>,
+  "version": "0.0.1",
+  "engines": {
+    "vscode": <%- JSON.stringify(vsCodeEngine) %>
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    <%- JSON.stringify(`onCommand:${name}.helloWorld`) %>
+  ],
+  "main": "./out/extension.js",<% if (insiders) { %>
+  "enabledApiProposals": [],<% } %>
+  "contributes": {
+    "commands": [
+      {
+        "command": <%- JSON.stringify(`${name}.helloWorld`) %>,
+        "title": "Hello World"
+      }
+    ]
+  },
+  "scripts": {
+    "vscode:prepublish": "<%= pkgManager %> run compile",
+    "compile": "tsc -p ./",
+    "watch": "tsc -watch -p ./",
+    "pretest": "<%= pkgManager %> run compile && <%= pkgManager %> run lint",
+    "lint": "eslint src --ext ts",
+    "test": "node ./out/test/runTest.js"<% if (insiders) { %>,
+    "update-proposed-api": "vscode-dts dev"<% } %>
+  },
+  "devDependencies": {
+    <%- dep("@types/vscode") %>,
+    <%- dep("@types/glob") %>,
+    <%- dep("@types/mocha") %>,
+    <%- dep("@types/node") %>,
+    <%- dep("@typescript-eslint/eslint-plugin") %>,
+    <%- dep("@typescript-eslint/parser") %>,
+    <%- dep("eslint") %>,
+    <%- dep("glob") %>,
+    <%- dep("mocha") %>,
+    <%- dep("typescript") %>,
+    <%- dep("@vscode/test-electron") %><% if (insiders) { %>,
+    <%- dep("vscode-dts") %><% } %>
+  }
 }

package/generators/app/templates/ext-command-ts/vsc-extension-quickstart.md

@@ -21,7 +21,6 @@
 * You can relaunch the extension from the debug toolbar after changing code in `src/extension.ts`.
 * You can also reload (`Ctrl+R` or `Cmd+R` on Mac) the VS Code window with your extension to load your changes.
 
-
 ## Explore the API
 
 * You can open the full set of our API when you open the file `node_modules/@types/vscode/index.d.ts`.
@@ -37,6 +36,7 @@
 
 ## Go further
 
+* [Follow UX guidelines](https://code.visualstudio.com/api/ux-guidelines/overview) to create extensions that seamlessly integrate with VS Code's native interface and patterns.
  * Reduce the extension size and improve the startup time by [bundling your extension](https://code.visualstudio.com/api/working-with-extensions/bundling-extension).
- * [Publish your extension](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) on the VSCode extension marketplace.
+ * [Publish your extension](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) on the VS Code extension marketplace.
  * Automate builds by setting up [Continuous Integration](https://code.visualstudio.com/api/working-with-extensions/continuous-integration).

package/generators/app/templates/ext-command-ts/vscode-webpack/package.json

@@ -1,54 +1,54 @@
 {
   "name": <%- JSON.stringify(name) %>,
-	"displayName": <%- JSON.stringify(displayName) %>,
-	"description": <%- JSON.stringify(description) %>,
-	"version": "0.0.1",
-	"engines": {
-		"vscode": <%- JSON.stringify(vsCodeEngine) %>
-	},
-	"categories": [
-		"Other"
-	],
-	"activationEvents": [
-        <%- JSON.stringify(`onCommand:${name}.helloWorld`) %>
-	],
-	"main": "./dist/extension.js",<% if (insiders) { %>
-	"enabledApiProposals": [],<% } %>
-	"contributes": {
-		"commands": [
-			{
-				"command": <%- JSON.stringify(`${name}.helloWorld`) %>,
-				"title": "Hello World"
-			}
-		]
-	},
-	"scripts": {
-		"vscode:prepublish": "<%= pkgManager %> run package",
-		"compile": "webpack",
-		"watch": "webpack --watch",
-		"package": "webpack --mode production --devtool hidden-source-map",
-		"compile-tests": "tsc -p . --outDir out",
-		"watch-tests": "tsc -p . -w --outDir out",
-		"pretest": "<%= pkgManager %> run compile-tests && <%= pkgManager %> run compile && <%= pkgManager %> run lint",
-		"lint": "eslint src --ext ts",
-		"test": "node ./out/test/runTest.js"<% if (insiders) { %>,
-		"update-proposed-api": "vscode-dts dev"<% } %>
-	},
-	"devDependencies": {
-		<%- dep("@types/vscode") %>,
-		<%- dep("@types/glob") %>,
-		<%- dep("@types/mocha") %>,
-		<%- dep("@types/node") %>,
-		<%- dep("@typescript-eslint/eslint-plugin") %>,
-		<%- dep("@typescript-eslint/parser") %>,
-		<%- dep("eslint") %>,
-		<%- dep("glob") %>,
-		<%- dep("mocha") %>,
-		<%- dep("typescript") %>,
-		<%- dep("ts-loader") %>,
-		<%- dep("webpack") %>,
-		<%- dep("webpack-cli") %>,
-		<%- dep("@vscode/test-electron") %><% if (insiders) { %>,
-		<%- dep("vscode-dts") %><% } %>
-	}
+  "displayName": <%- JSON.stringify(displayName) %>,
+  "description": <%- JSON.stringify(description) %>,
+  "version": "0.0.1",
+  "engines": {
+    "vscode": <%- JSON.stringify(vsCodeEngine) %>
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    <%- JSON.stringify(`onCommand:${name}.helloWorld`) %>
+  ],
+  "main": "./dist/extension.js",<% if (insiders) { %>
+  "enabledApiProposals": [],<% } %>
+  "contributes": {
+    "commands": [
+      {
+        "command": <%- JSON.stringify(`${name}.helloWorld`) %>,
+        "title": "Hello World"
+      }
+    ]
+  },
+  "scripts": {
+    "vscode:prepublish": "<%= pkgManager %> run package",
+    "compile": "webpack",
+    "watch": "webpack --watch",
+    "package": "webpack --mode production --devtool hidden-source-map",
+    "compile-tests": "tsc -p . --outDir out",
+    "watch-tests": "tsc -p . -w --outDir out",
+    "pretest": "<%= pkgManager %> run compile-tests && <%= pkgManager %> run compile && <%= pkgManager %> run lint",
+    "lint": "eslint src --ext ts",
+    "test": "node ./out/test/runTest.js"<% if (insiders) { %>,
+    "update-proposed-api": "vscode-dts dev"<% } %>
+  },
+  "devDependencies": {
+    <%- dep("@types/vscode") %>,
+    <%- dep("@types/glob") %>,
+    <%- dep("@types/mocha") %>,
+    <%- dep("@types/node") %>,
+    <%- dep("@typescript-eslint/eslint-plugin") %>,
+    <%- dep("@typescript-eslint/parser") %>,
+    <%- dep("eslint") %>,
+    <%- dep("glob") %>,
+    <%- dep("mocha") %>,
+    <%- dep("typescript") %>,
+    <%- dep("ts-loader") %>,
+    <%- dep("webpack") %>,
+    <%- dep("webpack-cli") %>,
+    <%- dep("@vscode/test-electron") %><% if (insiders) { %>,
+    <%- dep("vscode-dts") %><% } %>
+  }
 }

package/generators/app/templates/ext-command-ts/vscode-webpack/vsc-extension-quickstart.md

@@ -43,5 +43,5 @@
 ## Go further
 
 * Reduce the extension size and improve the startup time by [bundling your extension](https://code.visualstudio.com/api/working-with-extensions/bundling-extension).
-* [Publish your extension](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) on the VSCode extension marketplace.
+* [Publish your extension](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) on the VS Code extension marketplace.
 * Automate builds by setting up [Continuous Integration](https://code.visualstudio.com/api/working-with-extensions/continuous-integration).

package/generators/app/templates/ext-command-ts/vscode-webpack/vscode/tasks.json

@@ -6,10 +6,7 @@
 		{
 			"type": "npm",
 			"script": "watch",
-			"problemMatcher": [
-				"$ts-webpack-watch",
-				"$tslint-webpack-watch"
-			],
+			"problemMatcher": "$ts-webpack-watch",
 			"isBackground": true,
 			"presentation": {
 				"reveal": "never",
@@ -40,4 +37,4 @@
 			"problemMatcher": []
 		}
 	]
-}
+}

package/generators/app/templates/ext-command-ts/vscode-webpack/webpack.config.js

@@ -9,7 +9,7 @@ const path = require('path');
 
 /** @type WebpackConfig */
 const extensionConfig = {
-  target: 'node', // vscode extensions run in a Node.js-context 📖 -> https://webpack.js.org/configuration/node/
+  target: 'node', // VS Code extensions run in a Node.js-context 📖 -> https://webpack.js.org/configuration/node/
 	mode: 'none', // this leaves the source code as close as possible to the original (when packaging we set this to 'production')
 
   entry: './src/extension.ts', // the entry point of this extension, 📖 -> https://webpack.js.org/configuration/entry-context/

package/generators/app/templates/ext-command-web/README.md

@@ -24,8 +24,8 @@ For example:
 
 This extension contributes the following settings:
 
-* `myExtension.enable`: enable/disable this extension
-* `myExtension.thing`: set to `blah` to do something
+* `myExtension.enable`: Enable/disable this extension.
+* `myExtension.thing`: Set to `blah` to do something.
 
 ## Known Issues
 
@@ -47,17 +47,17 @@ Fixed issue #.
 
 Added features X, Y, and Z.
 
------------------------------------------------------------------------------------------------------------
+---
 
 ## Working with Markdown
 
-**Note:** You can author your README using Visual Studio Code.  Here are some useful editor keyboard shortcuts:
+You can author your README using Visual Studio Code.  Here are some useful editor keyboard shortcuts:
 
-* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux)
-* Toggle preview (`Shift+CMD+V` on macOS or `Shift+Ctrl+V` on Windows and Linux)
-* Press `Ctrl+Space` (Windows, Linux) or `Cmd+Space` (macOS) to see a list of Markdown snippets
+* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux).
+* Toggle preview (`Shift+Cmd+V` on macOS or `Shift+Ctrl+V` on Windows and Linux).
+* Press `Ctrl+Space` (Windows, Linux, macOS) to see a list of Markdown snippets.
 
-### For more information
+## For more information
 
 * [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
 * [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)

package/generators/app/templates/ext-command-web/package.json

@@ -1,52 +1,50 @@
 {
-	"name": <%- JSON.stringify(name) %>,
-	"displayName": <%- JSON.stringify(displayName) %>,
-	"description": <%- JSON.stringify(description) %>,
-	"version": "0.0.1",
-	"engines": {
-		"vscode": <%- JSON.stringify(vsCodeEngine) %>
-	},
-	"categories": [
-		"Other"
-	],
-	"activationEvents": [
-        <%- JSON.stringify(`onCommand:${name
-		}.helloWorld`) %>
-	],
-	"browser": "./dist/web/extension.js",
-	"contributes": {
-		"commands": [
-			{
-				"command": <%- JSON.stringify(`${name
-				}.helloWorld`) %>,
-				"title": "Hello World"
-			}
-		]
-	},
-	"scripts": {
-		"test": "vscode-test-web --browserType=chromium --extensionDevelopmentPath=. --extensionTestsPath=dist/web/test/suite/index.js",
-		"pretest": "<%= pkgManager %> run compile-web",
-		"vscode:prepublish": "<%= pkgManager %> run package-web",
-		"compile-web": "webpack",
-		"watch-web": "webpack --watch",
-		"package-web": "webpack --mode production --devtool hidden-source-map",
-		"lint": "eslint src --ext ts",
-		"run-in-browser": "vscode-test-web --browserType=chromium --extensionDevelopmentPath=. ."
-	},
-	"devDependencies": {
-		<%- dep("@types/vscode") %>,
-		<%- dep("@types/mocha") %>,
-		<%- dep("eslint") %>,
-		<%- dep("@typescript-eslint/eslint-plugin") %>,
-		<%- dep("@typescript-eslint/parser") %>,
-		<%- dep("mocha") %>,
-		<%- dep("typescript") %>,
-		<%- dep("@vscode/test-web") %>,
-		<%- dep("ts-loader") %>,
-		<%- dep("webpack") %>,
-		<%- dep("webpack-cli") %>,
-		<%- dep("@types/webpack-env") %>,
-		<%- dep("assert") %>,
-		<%- dep("process") %>
-	}
-}
+  "name": <%- JSON.stringify(name) %>,
+  "displayName": <%- JSON.stringify(displayName) %>,
+  "description": <%- JSON.stringify(description) %>,
+  "version": "0.0.1",
+  "engines": {
+    "vscode": <%- JSON.stringify(vsCodeEngine) %>
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    <%- JSON.stringify(`onCommand:${name}.helloWorld`) %>
+  ],
+  "browser": "./dist/web/extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": <%- JSON.stringify(`${name}.helloWorld`) %>,
+        "title": "Hello World"
+      }
+    ]
+  },
+  "scripts": {
+    "test": "vscode-test-web --browserType=chromium --extensionDevelopmentPath=. --extensionTestsPath=dist/web/test/suite/index.js",
+    "pretest": "<%= pkgManager %> run compile-web",
+    "vscode:prepublish": "<%= pkgManager %> run package-web",
+    "compile-web": "webpack",
+    "watch-web": "webpack --watch",
+    "package-web": "webpack --mode production --devtool hidden-source-map",
+    "lint": "eslint src --ext ts",
+    "run-in-browser": "vscode-test-web --browserType=chromium --extensionDevelopmentPath=. ."
+  },
+  "devDependencies": {
+    <%- dep("@types/vscode") %>,
+    <%- dep("@types/mocha") %>,
+    <%- dep("eslint") %>,
+    <%- dep("@typescript-eslint/eslint-plugin") %>,
+    <%- dep("@typescript-eslint/parser") %>,
+    <%- dep("mocha") %>,
+    <%- dep("typescript") %>,
+    <%- dep("@vscode/test-web") %>,
+    <%- dep("ts-loader") %>,
+    <%- dep("webpack") %>,
+    <%- dep("webpack-cli") %>,
+    <%- dep("@types/webpack-env") %>,
+    <%- dep("assert") %>,
+    <%- dep("process") %>
+  }
+}

package/generators/app/templates/ext-command-web/vsc-extension-quickstart.md

@@ -13,10 +13,10 @@
 
 ## Get up and running the Web Extension
 
-* `npm install`
-* place breakpoints in `src/web/extension.ts`
-* debug via F5 (Run Web Extension)
-* execute extension code via `F1 > Hello world`
+* Run `npm install`.
+* Place breakpoints in `src/web/extension.ts`.
+* Debug via F5 (Run Web Extension).
+* Execute extension code via `F1 > Hello world`.
 
 ## Make changes
 
@@ -38,6 +38,7 @@
 
 ## Go further
 
-* Check out the [Web Extension Guide](https://code.visualstudio.com/api/extension-guides/web-extensions)
-* [Publish your extension](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) on the VSCode extension marketplace.
+* [Follow UX guidelines](https://code.visualstudio.com/api/ux-guidelines/overview) to create extensions that seamlessly integrate with VS Code's native interface and patterns.
+* Check out the [Web Extension Guide](https://code.visualstudio.com/api/extension-guides/web-extensions).
+* [Publish your extension](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) on the VS Code extension marketplace.
 * Automate builds by setting up [Continuous Integration](https://code.visualstudio.com/api/working-with-extensions/continuous-integration).

package/generators/app/templates/ext-command-web/webpack.config.js

@@ -49,6 +49,9 @@ const webExtensionConfig = {
 		}]
 	},
 	plugins: [
+		new webpack.optimize.LimitChunkCountPlugin({
+			maxChunks: 1 // disable chunks by default since web extensions must be a single bundle
+		}),
 		new webpack.ProvidePlugin({
 			process: 'process/browser', // provide a shim for the global `process` variable
 		}),

package/generators/app/templates/ext-extensionpack/{gitattributes → .gitattributes}

@@ -1,3 +1,2 @@
 # Set default behavior to automatically normalize line endings.
 * text=auto
-

package/generators/app/templates/ext-extensionpack/README.md

@@ -1,12 +1,12 @@
-# README
+# <%- name %> README
 
-## This is the README for your extension pack "<%= name %>"
+## Working with Markdown
 
-You can author your README using Visual Studio Code.  Here are some useful editor keyboard shortcuts:
+You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
 
-* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux)
-* Toggle preview (`Shift+CMD+V` on macOS or `Shift+Ctrl+V` on Windows and Linux)
-* Press `Ctrl+Space` (Windows, Linux) or `Cmd+Space` (macOS) to see a list of Markdown snippets
+* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux).
+* Toggle preview (`Shift+Cmd+V` on macOS or `Shift+Ctrl+V` on Windows and Linux).
+* Press `Ctrl+Space` (Windows, Linux, macOS) to see a list of Markdown snippets.
 
 ## For more information
 

package/generators/app/templates/ext-extensionpack/package.json

@@ -1,16 +1,16 @@
 {
-    "name": <%- JSON.stringify(name) %>,
-    "displayName": <%- JSON.stringify(displayName) %>,
-    "description": <%- JSON.stringify(description) %>,
-    "version": "0.0.1",
-    "engines": {
-        "vscode": <%- JSON.stringify(vsCodeEngine) %>
-    },
-    "categories": [
-        "Extension Packs"
-    ],
-    "extensionPack": [ <% for (i=0; i<extensionList.length-1; i++) { %>
-        "<%- extensionList[i] %>", <%}%>
-        "<%- extensionList[extensionList.length-1]%>"
-    ]
-}
+  "name": <%- JSON.stringify(name) %>,
+  "displayName": <%- JSON.stringify(displayName) %>,
+  "description": <%- JSON.stringify(description) %>,
+  "version": "0.0.1",
+  "engines": {
+    "vscode": <%- JSON.stringify(vsCodeEngine) %>
+  },
+  "categories": [
+    "Extension Packs"
+  ],
+  "extensionPack": [ <% for (i=0; i<extensionList.length-1; i++) { %>
+    "<%- extensionList[i] %>", <%}%>
+    "<%- extensionList[extensionList.length-1]%>"
+  ]
+}

package/generators/app/templates/ext-keymap/{gitattributes → .gitattributes}

@@ -1,3 +1,2 @@
 # Set default behavior to automatically normalize line endings.
 * text=auto
-

package/generators/app/templates/ext-keymap/README.md

@@ -1,12 +1,15 @@
-# README
-## This is the README for your extension "<%= name %>"
-You can author your README using Visual Studio Code.  Here are some useful editor keyboard shortcuts:
+# <%- name %> README
 
-* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux)
-* Toggle preview (`Shift+CMD+V` on macOS or `Shift+Ctrl+V` on Windows and Linux)
-* Press `Ctrl+Space` (Windows, Linux) or `Cmd+Space` (macOS) to see a list of Markdown snippets
+## Working with Markdown
+
+You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
+
+* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux).
+* Toggle preview (`Shift+Cmd+V` on macOS or `Shift+Ctrl+V` on Windows and Linux).
+* Press `Ctrl+Space` (Windows, Linux, macOS) to see a list of Markdown snippets.
+
+## For more information
 
-### For more information
 * [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
 * [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)
 

package/generators/app/templates/ext-keymap/package.json

@@ -1,20 +1,20 @@
 {
-    "name": <%- JSON.stringify(name) %>,
-    "displayName": <%- JSON.stringify(displayName) %>,
-    "description": <%- JSON.stringify(description) %>,
-    "version": "0.0.1",
-    "engines": {
-        "vscode": <%- JSON.stringify(vsCodeEngine) %>
-    },
-    "categories": [
-        "Keymaps"
-    ],
-    "contributes": {
-        "keybindings": [
-            {
-                "key": "ctrl+.",
-                "command": "workbench.action.showCommands"
-            }
-        ]
-    }
-}
+  "name": <%- JSON.stringify(name) %>,
+  "displayName": <%- JSON.stringify(displayName) %>,
+  "description": <%- JSON.stringify(description) %>,
+  "version": "0.0.1",
+  "engines": {
+    "vscode": <%- JSON.stringify(vsCodeEngine) %>
+  },
+  "categories": [
+    "Keymaps"
+  ],
+  "contributes": {
+    "keybindings": [
+      {
+        "key": "ctrl+.",
+        "command": "workbench.action.showCommands"
+      }
+    ]
+  }
+}

package/generators/app/templates/ext-keymap/vsc-extension-quickstart.md

@@ -8,8 +8,8 @@
 ## Get up and running straight away
 
 * Press `F5` to open a new window with your extension loaded.
-* Press `Ctrl + .` instead of `Ctrl + Shift + P`
-* Verify that it will launch the Command Palette listing all available commands. The `Ctrl + .` keyboard shortcut was added as an example to you.
+* Press `Ctrl+.` instead of `Ctrl+Shift+P`.
+* Verify that it will launch the Command Palette listing all available commands. The `Ctrl+.` keyboard shortcut was added as an example to you.
 
 ## Make changes
 

package/generators/app/templates/ext-language/{gitattributes → .gitattributes}

@@ -1,3 +1,2 @@
 # Set default behavior to automatically normalize line endings.
 * text=auto
-

package/generators/app/templates/ext-language/README.md

@@ -24,8 +24,8 @@ For example:
 
 This extension contributes the following settings:
 
-* `myExtension.enable`: enable/disable this extension
-* `myExtension.thing`: set to `blah` to do something
+* `myExtension.enable`: Enable/disable this extension.
+* `myExtension.thing`: Set to `blah` to do something.
 
 ## Known Issues
 
@@ -47,17 +47,17 @@ Fixed issue #.
 
 Added features X, Y, and Z.
 
------------------------------------------------------------------------------------------------------------
+---
 
 ## Working with Markdown
 
-**Note:** You can author your README using Visual Studio Code.  Here are some useful editor keyboard shortcuts:
+You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
 
-* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux)
-* Toggle preview (`Shift+CMD+V` on macOS or `Shift+Ctrl+V` on Windows and Linux)
-* Press `Ctrl+Space` (Windows, Linux) or `Cmd+Space` (macOS) to see a list of Markdown snippets
+* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux).
+* Toggle preview (`Shift+Cmd+V` on macOS or `Shift+Ctrl+V` on Windows and Linux).
+* Press `Ctrl+Space` (Windows, Linux, macOS) to see a list of Markdown snippets.
 
-### For more information
+## For more information
 
 * [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
 * [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)