fix: exclude auto update changelog commit (#135)

- Exclude auto update changelog from bot commit in CHANGELOG and
releases
- Update full commands explain in readme

.goreleaser.yaml

@@ -25,6 +25,7 @@ changelog:
         exclude:
             - "(?i)^fix\\(ci\\)"
             - "(?i)^fix\\(release\\)"
+            - "(?i)^docs\\(changelog\\)"
     groups:
         - title: "Features"
           regexp: '(?i)^.*?feat(\(.+\))?!?:.+$'

CHANGELOG.md

@@ -4,10 +4,6 @@ All notable changes to this project are documented in this file.
 
 ## [v0.6.0](https://github.com/versenilvis/iris/releases/tag/v0.6.0) - 2026-08-09
 
-### Documentation
-
-- Update for v0.5.4 [skip ci] ([bf4f42](https://github.com/versenilvis/iris/commit/bf4f424e794ebb0d9a8d73a17967757ead92205d))
-
 ### Features
 
 - Atuin history support ([#134](https://github.com/versenilvis/iris/issues/134)) ([dd1fb1](https://github.com/versenilvis/iris/commit/dd1fb156fcbcb10bfc527f9ad4c71e4d240b1a2b))
@@ -18,10 +14,6 @@ All notable changes to this project are documented in this file.
 
 - Update stale vendorHash for new go.mod dependencies ([#132](https://github.com/versenilvis/iris/issues/132)) ([e334af](https://github.com/versenilvis/iris/commit/e334af8d883b62a40e2c02cc11b001f68cdc7153))
 
-### Documentation
-
-- Update for v0.5.3 [skip ci] ([55d559](https://github.com/versenilvis/iris/commit/55d55957c0b9e6ee17e2a6598e33a2c128647567))
-
 ## [v0.5.3](https://github.com/versenilvis/iris/releases/tag/v0.5.3) - 2026-08-07
 
 ### Bug fixes

README.md

@@ -292,59 +292,59 @@ iris config show
 
 ```toml
 [core]
-version = 1
+version = 1           # config schema version
-shell = ""          # "zsh", "bash", "fish", or empty for auto-detection
+shell = ""            # "zsh", "bash", "fish", or empty for auto-detect
-shell-login = false # run the selected shell as a login shell; can also be enabled with iris --shell-login
+shell-login = false   # run shell as a login shell (also: iris --shell-login)
 mode = "last"         # "last", "spec", or "history"
-debug = false
+debug = false         # verbose logging to iris.log (also: iris -d)
-expand-alias = true
+expand-alias = true   # expand aliases before matching
-auto-execute = false
+auto-execute = false  # run suggestion immediately instead of inserting it
-atuin-history = 0
+atuin-history = 0     # 0 = shell history, 1 = atuin, 2 = both
-atuin-db-path = ""
+atuin-db-path = ""    # path to atuin's history.db, empty = use default
 
 [ui]
 style = "modern"       # "modern" or "classic"
-ghost-text = true
+ghost-text = true      # faded inline preview of top suggestion
-hidden-files = false
+hidden-files = false   # include dotfiles in suggestions
-max-suggestions = 100
+max-suggestions = 100  # max suggestions ranked before display
-max-height = 15
+max-height = 15        # max visible rows in the menu
-max-width = 0
+max-width = 0          # max menu width, 0 = auto
-nerd-fonts = true
+nerd-fonts = true      # use nerd-font icons
 
 [keybindings]
-toggle-mode = "ctrl+r"
+toggle-mode = "ctrl+r"     # switch spec/history mode
-toggle-menu = "shift+tab"
+toggle-menu = "shift+tab"  # show or hide the suggestion menu
-select = "tab"
+select = "tab"             # accept the selected suggestion
-navigate-up = "up"
+navigate-up = "up"         # select up, or open history if empty
-navigate-down = "down"
+navigate-down = "down"     # select down, or open history if empty
-navigate-right = "right"
+navigate-right = "right"   # accept ghost text
 
 [git]
-filter-active-branch = true
+filter-active-branch = true  # exclude current branch from suggestions
-deduplicate-branches = true
+deduplicate-branches = true  # merge same-name local/remote branches
 
 [updater]
-check-on-startup = true
+check-on-startup = true  # check for updates on startup
 channel = "stable"       # "stable" or "nightly"
-check-interval = "24h"
+check-interval = "24h"   # min time between update checks
-auto-update = 0 # 0 = off, 1 = auto-install, 2 = always confirm first
+auto-update = 0          # 0 = off, 1 = auto-install, 2 = confirm first
 
 [ai]
 enabled = false
 provider = "groq"  # "groq" or "ollama"
-debounce_ms = 400
+debounce_ms = 400  # ms to wait before querying the AI
 
 # please use free subscription, that is enough for your daily usage
 [ai.providers.groq]
 endpoint = "https://api.groq.com/openai/v1/chat/completions"
 api_key_env = "GROQ_API_KEY"       # or set api_key directly
 model = "llama-3.3-70b-versatile"
-timeout_ms = 3000
+timeout_ms = 3000                  # ms before giving up
 
 [ai.providers.ollama]
 endpoint = "http://localhost:11434/v1/chat/completions"
 model = "qwen2.5-coder"
-timeout_ms = 5000
+timeout_ms = 5000  # ms before giving up
 ```
 
 > [!NOTE]

cliff.toml

@@ -38,6 +38,8 @@ commit_parsers = [
     { message = "(?i)^fix", group = "Bug fixes" },
     { message = "(?i)^perf", group = "Performance" },
     { message = "(?i)^refactor", group = "Refactors" },
+    # the CI bot's own changelog-update commit, not a user-facing doc change
+    { message = "(?i)^docs\\(changelog\\)", skip = true },
     { message = "(?i)^docs?", group = "Documentation" },
     { message = "(?i)^chore", skip = true },
     { message = "(?i)^build", skip = true },