DOC-3147: The default value of pagebreak_split_block is now true to match the new pagebreak_separator default.

Author: kemister85

modules/ROOT/pages/8.0-release-notes.adoc

@@ -125,7 +125,34 @@ For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-a
 // #TINY-vwxyz1
 
 // CCFR here.
+=== The default value of `pagebreak_split_block` is now `true` to match the new `pagebreak_separator` default
+// #TINY-12462
 
+The default value for the `pagebreak_split_block` option has been changed from `false` to `true`. This change improves the user experience when inserting page breaks within block elements such as paragraphs, lists, or tables. When enabled:
+
+* Page breaks will automatically split the block element at the cursor position
+* Content after the page break will be moved to a new block element of the same type
+* The structure and formatting of the content is preserved on both sides of the page break
+
+For example, with this HTML content:
+
+[source,html]
+----
+<p>First page</p>
+<p>Second page</p>
+----
+
+When placing the cursor after the word "Second" and inserting a page break, the result will be:
+
+[source,html]
+----
+<p>First page</p>
+<p>Second<div style="break-after: page"></div> page</p>
+----
+
+This behavior is now enabled by default, but can be disabled by setting `pagebreak_split_block: false` in the editor configuration.
+
+For more information on the `pagebreak_split_block` option, see xref:pagebreak.adoc#pagebreak_split_block[pagebreak_split_block].
 
 [[removed]]
 == Removed

modules/ROOT/partials/configuration/pagebreak_split_block.adoc

@@ -1,22 +1,23 @@
 [[pagebreak_split_block]]
 == `+pagebreak_split_block+`
 
-When enabled this option makes it easier to split block elements with a page break.
+By default, page breaks automatically split block elements (such as paragraphs, lists, or tables) at the cursor position while preserving the structure and formatting of the content. This option can be used to disable this behavior by setting it to `false` if this is undesired.
 
 *Type:* `+Boolean+`
 
-*Default value:* `+false+`
+*Default value:* `+true+`
 
 *Possible values:* `+true+`, `+false+`
 
 === Example: using `+pagebreak_split_block+`
 
 [source,js]
 ----
+// Disable the block splitting behavior
 tinymce.init({
   selector: 'textarea',  // change this value according to your HTML
   plugins: 'pagebreak',
   toolbar: 'pagebreak',
-  pagebreak_split_block: true
+  pagebreak_split_block: false
 });
 ----