From f9257bf8c65561082f40f32a250c642c854d3a06 Mon Sep 17 00:00:00 2001 From: Nathan Ferguson Date: Thu, 27 Aug 2026 12:29:17 -0400 Subject: [PATCH] Document break tag theme rendering behavior Co-authored-by: Pi AI (openai/gpt-5.1) --- lib/liquid/tags/break.rb | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/lib/liquid/tags/break.rb b/lib/liquid/tags/break.rb index cec640074..0c94f9b3f 100644 --- a/lib/liquid/tags/break.rb +++ b/lib/liquid/tags/break.rb @@ -3,19 +3,31 @@ module Liquid # Break tag to be used to break out of a for loop. # - # == Basic Usage: + # == Iteration usage: # {% for item in collection %} # {% if item.condition %} # {% break %} # {% endif %} # {% endfor %} # + # == Theme file rendering usage: + # {% if condition %} + # {% break %} + # {% endif %} + # # @liquid_public_docs # @liquid_type tag # @liquid_category iteration # @liquid_name break # @liquid_summary - # Stops a [`for` loop](/docs/api/liquid/tags/for) from iterating. + # Stops a [`for` loop](/docs/api/liquid/tags/for) from iterating, or stops the + # rest of a file from rendering when used outside of a loop. + # @liquid_description + # Inside a `for` or `tablerow` loop, `break` stops the loop. + # + # Outside of a loop, `break` stops the rest of the current file from + # rendering. Sections, blocks, and snippets each render in their own context, so + # rendering continues normally in the file that rendered them. # @liquid_syntax # {% break %} class Break < Tag