docs: update README

Author: muthukrishnan24

README.md

@@ -23,6 +23,7 @@ commitlint checks if your commit message meets the [conventional commit format](
     - [Using go](#using-go)
   - [Setup](#setup)
     - [Manual](#manual)
+    - [Remove](#remove)
   - [Quick Test](#quick-test)
   - [Commands](#commands)
     - [config](#config)
@@ -34,6 +35,10 @@ commitlint checks if your commit message meets the [conventional commit format](
     - [debug](#debug)
   - [Default Config](#default-config)
     - [Commit Types](#commit-types)
+  - [Ignore Patterns](#ignore-patterns)
+    - [Default Ignore Patterns](#default-ignore-patterns)
+    - [Custom Ignore Patterns](#custom-ignore-patterns)
+    - [Disabling Default Ignores](#disabling-default-ignores)
   - [Available Rules](#available-rules)
   - [Available Formatters](#available-formatters)
   - [Extensibility](#extensibility)
@@ -75,13 +80,29 @@ commitlint init --global --hookspath /path/to/hooks
 
 ### Manual
 
-- run `commitlint hook create` to create `.commitlint/hooks` containing git hooks
-  - pass `--hookspath` to customize the hooks output path
+- run `commitlint hook` to create `.commitlint/hooks` containing git hooks
+  - pass `--hookspath` or `-p` to customize the hooks output path
 - To enable in single repo
   - run `git config core.hooksPath /path/to/.commitlint/hooks`
 - To enable globally
   - run `git config --global core.hooksPath /path/to/.commitlint/hooks`
 
+### Remove
+
+- To remove hooks from a single repository
+
+```bash
+commitlint remove
+```
+
+- To remove hooks globally
+
+```bash
+commitlint remove --global
+```
+
+Both commands ask for confirmation before unsetting `core.hooksPath` in git config. Hook files are left intact.
+
 ## Quick Test
 
 - Valid commit message
@@ -102,9 +123,11 @@ echo "fear: do not fear for commit message" | commitlint lint
 
 ### config
 
-- To create config file, run `commitlint config create` this will create `commitlint.yaml`
+- To create a config file, run `commitlint config create`, this will create `.commitlint.yaml` with only the enabled rules and their settings (compact format)
+
+- To create a config file with **all** rules and settings written out (including disabled ones), run `commitlint config create --all`
 
-- To validate config file, run `commitlint config check --config=/path/to/conf.yaml`
+- To validate a config file, run `commitlint config check /path/to/conf.yaml`
 
 ### lint
 
@@ -136,7 +159,9 @@ To lint a message, you can use any one of the following
 
 ### hook
 
-- To create hook files, run `commitlint hook create`
+- To create hook files, run `commitlint hook`
+  - pass `--hookspath` or `-p` to customize the hooks output directory
+  - pass `--replace` or `-r` to overwrite existing hook files
 
 ### debug
 
@@ -147,7 +172,7 @@ To lint a message, you can use any one of the following
 ## Default Config
 
 ```yaml
-min-version: v0.9.0
+min-version: v0.11.0
 formatter: default
 rules:
 - header-min-length
@@ -157,15 +182,20 @@ rules:
 - type-enum
 severity:
   default: error
+  rules: {}
 settings:
   body-max-line-length:
-    argument: 72
+    argument: 100
+    flags: {}
   footer-max-line-length:
+    argument: 100
+    flags: {}
+  header-max-length:
     argument: 72
+    flags: {}
   header-min-length:
     argument: 10
-  header-max-length:
-    argument: 50
+    flags: {}
   type-enum:
     argument:
     - feat
@@ -179,6 +209,9 @@ settings:
     - ci
     - chore
     - revert
+    flags: {}
+disable-default-ignores: false
+ignores: []
 ```
 
 ### Commit Types
@@ -199,6 +232,53 @@ Commonly used commit types from [Conventional Commit Types](https://github.com/c
 | chore    | Other changes that don't modify src or test files                                |
 | revert   | Reverts a previous commit                                                        |
 
+## Ignore Patterns
+
+commitlint automatically skips linting for commit messages generated by git (merges, reverts, fixups, etc.).
+If the **first line** of a commit message matches any ignore pattern, linting is skipped entirely.
+
+### Default Ignore Patterns
+
+The following patterns are enabled by default
+(source: [`config/default.go`](config/default.go)):
+
+| Pattern | Matches |
+| :--- | :--- |
+| `^Merge pull request #\d+` | GitHub pull request merges |
+| `^Merge .+ into .+` | Generic merge (X into Y) |
+| `^Merge branch '.+'` | `git merge` branch |
+| `^Merge tag '.+'` | `git merge` tag |
+| `^Merge remote-tracking branch '.+'` | `git merge` remote-tracking branch |
+| `^Merged .+ (in\|into) .+` | Azure DevOps / Bitbucket merged |
+| `^Merged PR #?\d+` | Azure DevOps pull request |
+| `^(R\|r)evert ` | `git revert` |
+| `^(R\|r)eapply ` | `git reapply` |
+| `^(amend\|fixup\|squash)! ` | `git commit --fixup/--squash/--amend` |
+| `^Automatic merge` | Automatic merges |
+| `^Auto-merged .+ into .+` | Auto-merged branches |
+| `^Initial commit$` | Initial commit (exact match) |
+
+### Custom Ignore Patterns
+
+Add your own patterns in the config file under `ignores:`. User-defined patterns are
+**additive**, they are checked alongside the built-in defaults.
+
+```yaml
+ignores:
+  - "^WIP "
+  - "^TICKET-\\d+"
+```
+
+### Disabling Default Ignores
+
+If you want **only** your custom patterns (no built-in defaults), set `disable-default-ignores: true`:
+
+```yaml
+disable-default-ignores: true
+ignores:
+  - "^WIP "
+```
+
 ## Available Rules
 
 The list of available lint rules
@@ -255,12 +335,24 @@ Total 1 errors, 0 warnings, 0 other severities
 
   Place `.commitlint.yaml` file in repo root directory. linter follows [config precedence](#precedence).
 
-  To create a sample config, run `commitlint config create`
+  To create a sample config, run `commitlint config create` (or `commitlint config create --all` to include all available settings)
 
 - How can I skip lint check for a commit?
 
   use `--no-verify` flag with `git commit` which skips commit hooks
 
+- How does commitlint handle merge / revert commits?
+
+  commitlint ships with [built-in ignore patterns](#default-ignore-patterns) that
+  automatically skip linting for merge commits, reverts, fixups, squashes, and other
+  git-generated messages. You can add your own patterns with the `ignores` config key,
+  or disable the defaults with `disable-default-ignores: true`.
+
+- Can I use the old `version` config key?
+
+  Yes. The `version` key is still accepted for backward compatibility, but new config
+  files should use `min-version` instead.
+
 ## License
 
 All packages are licensed under [MIT License](LICENSE.md)