feat(eslint-config-ng): officially release strict config

projects/eslint-config-ng/README.md

@@ -1,10 +1,9 @@
-This library provides some default config you can use for ESLint in an Angular project. It gives you all the recommended, community-standard rules from [`ESLint`](https://eslint.org/docs/rules/),
-[`@typescript-eslint`](https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/src/configs/eslint-recommended.ts), and [`@angular-eslint/recommended`](https://github.com/angular-eslint/angular-eslint), plus these additions and changes:
+This library provides some default config you can use for ESLint in an Angular project.
 
-- Code complexity rules to keep your functions and files focused and readable
-- Relaxed rules around `ban-types` that Simonton Software has found unuseful
+# "Recommended" Config
 
-# Installation
+Follow these instructions to get all the community-recommended config from [`ESLint`](https://eslint.org/docs/rules/),
+[`@typescript-eslint`](https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/src/configs/eslint-recommended.ts), and [`@angular-eslint`](https://github.com/angular-eslint/angular-eslint).
 
 1. First install [Angular ESLint](https://github.com/angular-eslint/angular-eslint), following their instructions for your situation. Make sure it is working with their default config.
 1. `npm install --save-dev @s-libs/eslint-config-ng`
@@ -17,16 +16,38 @@ This library provides some default config you can use for ESLint in an Angular p
        {
          "files": ["*.ts"],
          "rules": {
-           "@angular-eslint/directive-selector": [
-             "error",
-             { "type": "attribute", "prefix": "app", "style": "camelCase" }
-           ],
-           "@angular-eslint/component-selector": [
-             "error",
-             { "type": "element", "prefix": "app", "style": "kebab-case" }
-           ]
+           "@angular-eslint/directive-selector": ["error", { "type": "attribute", "prefix": "app", "style": "camelCase" }],
+           "@angular-eslint/component-selector": ["error", { "type": "element", "prefix": "app", "style": "kebab-case" }]
          }
        }
      ]
    }
    ```
+
+# Strict Config
+
+Use these instructions for much stricter linting, start with the instructions above then continue with these. It starts with _all_ rules from the libraries above, then turns _off_ or modifies rules that Simonton Software subjectively thinks makes the config better.
+
+1. Follow the instructions above for recommended config and ensure it works.
+1. `npm install --save-dev eslint-config-prettier`
+1. Add the `parserOptions` to the `.eslintrc.json` file you created, so it looks like this:
+
+   ```json
+   {
+     "extends": "@s-libs/eslint-config-ng",
+     "overrides": [
+       {
+         "files": ["*.ts"],
+         "parserOptions": {
+           "project": ["tsconfig.(app|spec).json"]
+         },
+         "rules": {
+           "@angular-eslint/directive-selector": ["error", { "type": "attribute", "prefix": "app", "style": "camelCase" }],
+           "@angular-eslint/component-selector": ["error", { "type": "element", "prefix": "app", "style": "kebab-case" }]
+         }
+       }
+     ]
+   }
+   ```
+
+**Warning:** the configs from underlying libraries is not as stable as the ones used for their "recommended" configs. It can change with minor version updates to the underlying libraries.