readme: enhancements and adjustments

Author: Conduitry

README.md

@@ -4,15 +4,15 @@ An ESLint plugin for Svelte v3 components.
 
 ## Features
 
-- Svelte compiler errors and warnings are exposed as ESLint messages
+- Svelte compiler errors and warnings are exposed as ESLint errors and warnings
 - Variables referred to in your template won't be marked as unused in your scripts
 - References to store auto-subscriptions are considered references to the underlying variables
 - Messages about self-assignments are suppressed, as this is an official pattern for manually triggering reactive updates
 - Messages about unused labels called `$` are suppressed, as this is the syntax for reactive assignments
 
 ## Installation
 
-For now, this is not published to npm. Install from Git tags. See [the documentation on `npm install`](https://docs.npmjs.com/cli/install) for how to do this.
+For now, this is not published to npm. You can still install it from Git tags. See the [`npm install` documentation](https://docs.npmjs.com/cli/install) for how to do this.
 
 Untagged releases may depend on unreleased Svelte 3 features. Tagged releases should always work with the specified Svelte version. The latest tagged version requires at least Svelte 3.0.0-alpha21.
 
@@ -51,19 +51,29 @@ If you are linting a Sapper project, you'll need to change the `svelte3/extensio
 
 You'll need the [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) extension installed.
 
-If you're using a different extension than `.html` for your Svelte components, you'll need to configure `files.associations` to associate it with the `html` language.
-
-Then, you'll need to tell the ESLint extension to also lint files with language `html` and to enable automatically fixable problems. The default languages it lints are `javascript` and `javascriptreact`, so put this in your `settings.json`:
+If you're using an extension other than `.html` for your Svelte components, you'll need to configure `files.associations` to associate it with the `html` language. In your `settings.json`:
 
+```json
+{
+  "files.associations": {
+    "*.your-extension": "html"
+  }
+}
 ```
-	"eslint.validate": [
-		"javascript",
-		"javascriptreact",
-		{
-			"language": "html",
-			"autoFix": true,
-		},
-	],
+
+Then, you'll need to tell the ESLint extension to also lint files with language `html` and to enable autofixing problems. If you haven't adjusted the `eslint.validate` setting, it defaults to `javascript` and `javascriptreact`, so put this in your `settings.json`:
+
+```json
+{
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    {
+      "language": "html",
+      "autoFix": true
+    }
+  ]
+}
 ```
 
 Reload VS Code and give it a go!
@@ -72,14 +82,14 @@ Reload VS Code and give it a go!
 
 You'll need the [linter](https://atom.io/packages/linter) and [linter-eslint](https://atom.io/packages/linter-eslint) packages installed.
 
-If you're using a different extension than `.html` for your Svelte components, you'll need to configure `core.customFileTypes` to associate it with the `test.html.basic` language. In `config.cson`:
+If you're using an extension other than `.html` for your Svelte components, you'll need to configure `*.core.customFileTypes` to associate it with the `test.html.basic` language. In your `config.cson`:
 
-```
+```cson
 "*":
   core:
     customFileTypes:
       "text.html.basic": [
-        "svelte"
+        "your-extension"
       ]
 ```
 
@@ -89,19 +99,19 @@ Reload Atom and give it a go!
 
 ### Sublime Text
 
-You'll need the [SublimeLinter](https://github.com/SublimeLinter/SublimeLinter) and [SublimeLinter-eslint](https://github.com/SublimeLinter/SublimeLinter-eslint) package installed.
+You'll need the [SublimeLinter](https://github.com/SublimeLinter/SublimeLinter) and [SublimeLinter-eslint](https://github.com/SublimeLinter/SublimeLinter-eslint) packages installed.
 
-If you're using a different extension than `.html` for your Svelte components, you'll need to configure Sublime to associate it with the `text.html` syntax.
+If you're using an extension other than `.html` for your Svelte components, you'll need to configure Sublime to associate it with the `text.html` syntax. Go to `View > Syntax > Open all with current extension as... > HTML`.
 
-Then, you'll need to tell SublimeLinter-eslint to lint entire files with the `text.html` syntax, and not just the contents of their `<script>` tags (which is the default). In your SublimeLinter configuration, you'll need to add `text.html` to `linters.eslint.selector`. Starting with the default values, this would mean:
+Then, you'll need to tell SublimeLinter-eslint to lint entire files with the `text.html` syntax, and not just the contents of their `<script>` tags (which is the default). In your SublimeLinter configuration, you'll need to add `text.html` to `linters.eslint.selector`. If you're starting with the default values, this would mean:
 
-```
+```json
 {
-	"linters": {
-		"eslint": {
-			"selector": "source.js - meta.attribute-with-value, text.html"
-		}
-	}
+  "linters": {
+    "eslint": {
+      "selector": "source.js - meta.attribute-with-value, text.html"
+    }
+  }
 }
 ```