DOC-3189: Refactor promotion documentation and update references to new promotions page.

kemister85 · kemister85 · commit 51af4ffae8ad · 2025-04-01T15:05:47.000+10:00
diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
@@ -239,7 +239,7 @@
 ** xref:editor-important-options.adoc[Integration options]
 ** xref:editor-size-options.adoc[Size]
 ** xref:editor-save-and-submit.adoc[Save and submit]
-** xref:editor-premium-upgrade-promotion.adoc[Premium upgrade promotion]
+** xref:promotions.adoc[Promotions]
 * Interface
 ** Editor modes
 *** xref:use-tinymce-classic.adoc[Classic editing mode]
diff --git a/modules/ROOT/pages/initial-configuration.adoc b/modules/ROOT/pages/initial-configuration.adoc
@@ -29,7 +29,7 @@ Editor options related to saving or submitting editor content.
 
 |
 [.lead]
-xref:editor-premium-upgrade-promotion.adoc[Premium upgrade promotion]
+xref:promotions.adoc[Promotions]
 
 Editor options related to turning the Premium promotion display off.
 
diff --git a/modules/ROOT/pages/promotions.adoc b/modules/ROOT/pages/promotions.adoc
@@ -6,7 +6,7 @@
 include::partial$misc/premium-upgrade-promotion-option.adoc[]
 
 [[premium-upgrade-promotion-defaults]]
-=== Premium upgrade promotion defaults
+== Premium upgrade promotion defaults
 
 When the Community distribution of {productname} 6.2 is running as a self-hosted instance, an *Upgrade* promotion button appears in the unused corner of the editor menu bar by default. The button does not appear when Community distributions of {productname} are running on the {cloudname}.
 
diff --git a/modules/ROOT/partials/configuration/onboarding.adoc b/modules/ROOT/partials/configuration/onboarding.adoc
@@ -0,0 +1,22 @@
+[[onboarding]]
+== `+onboarding+`
+
+The cloud version of {productname} contains a promotion for paid features included in the 14-day trial. This promotion can be toggled on or off with the onboarding option.
+
+The promotion will automatically disappear when the trial ends.
+
+*Type:* `+Boolean+`
+
+*Default value:* `+true+` for cloud instances; otherwise `+false+`.
+
+*Possible values:* `+true+`, `+false+`
+
+=== Example: using cloud `+onboarding+`
+
+[source,js]
+----
+tinymce.init({
+  selector: "textarea",  // change this value according to your HTML
+  onboarding: false
+});
+----
diff --git a/modules/ROOT/partials/configuration/promotion.adoc b/modules/ROOT/partials/configuration/promotion.adoc
@@ -9,9 +9,9 @@
 
 *Possible values:* `+true+`, `+false+`
 
-See xref:editor-premium-upgrade-promotion.adoc#premium-upgrade-promotion-defaults[Premium upgrade promotion defaults] for details.
+See xref:promotions.adoc#premium-upgrade-promotion-defaults[Premium upgrade promotion defaults] for details.
 
-=== Example: using `+promotion+`
+=== Example: using open source `+promotion+`
 
 [source,js]
 ----
diff --git a/modules/ROOT/partials/misc/premium-upgrade-promotion-option.adoc b/modules/ROOT/partials/misc/premium-upgrade-promotion-option.adoc
@@ -1,4 +1,6 @@
-[[premium-upgrade-promotion-option]]
-== Premium upgrade promotion option
+[[options]]
+== Options
 
-include::partial$configuration/promotion.adoc[leveloffset=+1]
+include::partial$configuration/promotion.adoc[leveloffset=+1]
+
+include::partial$configuration/onboarding.adoc[leveloffset=+1]

Original file line number	Diff line number	Diff line change
`@@ -29,7 +29,7 @@ Editor options related to saving or submitting editor content.`
`29`	`29`
`30`	`30`	`\|`
`31`	`31`	`[.lead]`
`32`		`-xref:editor-premium-upgrade-promotion.adoc[Premium upgrade promotion]`
	`32`	`+xref:promotions.adoc[Promotions]`
`33`	`33`
`34`	`34`	`Editor options related to turning the Premium promotion display off.`
`35`	`35`