Deploying to gh-pages from @ a92dbdc 🚀

Author: bearomorphism

exit_codes/index.html

@@ -2486,6 +2486,20 @@ <h3 id="using-no-raise-flag">Using <code>--no-raise</code> Flag<a class="headerl
 <li><strong>Mixed format</strong>: <code>21,NO_COMMITS_FOUND,4</code></li>
 </ul>
 <p>Multiple exit codes can be specified as a comma-separated list.</p>
+<div class="admonition warning">
+<p class="admonition-title">Flag placement</p>
+<p><code>--no-raise</code> / <code>-nr</code> is a <strong>top-level Commitizen flag</strong>, so it must be passed
+<strong>before</strong> the subcommand:</p>
+<div class="highlight"><pre><span></span><code>cz<span class="w"> </span>--no-raise<span class="w"> </span><span class="m">21</span><span class="w"> </span>bump<span class="w"> </span>--yes<span class="w">        </span><span class="c1"># ✅ correct</span>
+cz<span class="w"> </span>-nr<span class="w"> </span><span class="m">21</span><span class="w"> </span>bump<span class="w"> </span>--yes<span class="w">               </span><span class="c1"># ✅ correct (short form)</span>
+</code></pre></div>
+<p>Placing it after the subcommand fails with exit code 18
+(<code>InvalidCommandArgumentError</code>):</p>
+<div class="highlight"><pre><span></span><code>cz<span class="w"> </span>bump<span class="w"> </span>--yes<span class="w"> </span>--no-raise<span class="w"> </span><span class="m">21</span><span class="w">        </span><span class="c1"># ❌ wrong</span>
+<span class="c1"># Invalid commitizen arguments were found: `--no-raise`.</span>
+<span class="c1"># Please use -- separator for extra git args</span>
+</code></pre></div>
+</div>
 <h3 id="common-use-cases">Common Use Cases<a class="headerlink" href="#common-use-cases" title="Permanent link">&para;</a></h3>
 <h4 id="ignoring-no-increment-errors">Ignoring No Increment Errors<a class="headerlink" href="#ignoring-no-increment-errors" title="Permanent link">&para;</a></h4>
 <p>The most common use case is to ignore <code>NoneIncrementExit</code> (exit code 21) when running <code>cz bump</code>. This allows the command to succeed even when no commits are eligible for a version bump:</p>
@@ -2560,7 +2574,7 @@ <h3 id="example-cicd-pipeline">Example: CI/CD Pipeline<a class="headerlink" href
     <span class="md-icon" title="Last update">
       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
     </span>
-    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="December 10, 2025 14:53:22 UTC">December 10, 2025</span>
+    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="May 12, 2026 01:58:49 UTC">May 12, 2026</span>
   </span>
 
 

exit_codes/index.md

@@ -57,6 +57,23 @@ The `--no-raise` (or `-nr`) flag allows you to specify exit codes that should no
 
 Multiple exit codes can be specified as a comma-separated list.
 
+Flag placement
+
+`--no-raise` / `-nr` is a **top-level Commitizen flag**, so it must be passed **before** the subcommand:
+
+```
+cz --no-raise 21 bump --yes        # ✅ correct
+cz -nr 21 bump --yes               # ✅ correct (short form)
+```
+
+Placing it after the subcommand fails with exit code 18 (`InvalidCommandArgumentError`):
+
+```
+cz bump --yes --no-raise 21        # ❌ wrong
+# Invalid commitizen arguments were found: `--no-raise`.
+# Please use -- separator for extra git args
+```
+
 ### Common Use Cases
 
 #### Ignoring No Increment Errors

images/cli_interactive/bump.gif

@@ -465,6 +465,23 @@ The `--no-raise` (or `-nr`) flag allows you to specify exit codes that should no
 
 Multiple exit codes can be specified as a comma-separated list.
 
+Flag placement
+
+`--no-raise` / `-nr` is a **top-level Commitizen flag**, so it must be passed **before** the subcommand:
+
+```
+cz --no-raise 21 bump --yes        # ✅ correct
+cz -nr 21 bump --yes               # ✅ correct (short form)
+```
+
+Placing it after the subcommand fails with exit code 18 (`InvalidCommandArgumentError`):
+
+```
+cz bump --yes --no-raise 21        # ❌ wrong
+# Invalid commitizen arguments were found: `--no-raise`.
+# Please use -- separator for extra git args
+```
+
 ### Common Use Cases
 
 #### Ignoring No Increment Errors