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

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]

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.
 

modules/ROOT/pages/editor-premium-upgrade-promotion.adoc → 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}.
 

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
+});
+----

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]
 ----

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]