From 3fa467affacc7527bf18363680cf30c58efb8db2 Mon Sep 17 00:00:00 2001
From: Avi Schwab <froboy@gmail.com>
Date: Mon, 11 Dec 2023 17:08:10 -0600
Subject: [PATCH] docs: DS-806 Add Program/Program Subcategory LB docs

---
 .../program-subcategory/_index.md             | 14 +++++++++++
 .../content-types/program/_index.md           | 25 +++++++++++++++++++
 2 files changed, 39 insertions(+)

diff --git a/content/en/docs/user-documentation/content-types/program-subcategory/_index.md b/content/en/docs/user-documentation/content-types/program-subcategory/_index.md
index 1d349acef..e3cd51153 100644
--- a/content/en/docs/user-documentation/content-types/program-subcategory/_index.md
+++ b/content/en/docs/user-documentation/content-types/program-subcategory/_index.md
@@ -71,3 +71,17 @@ The Sidebar Area will change the layout of the page into two columns once you en
 ### Bottom Area
 
 Use the Bottom Area for anchoring elements, such as [small banners](../../paragraphs/small-banner) and [webforms](../../paragraphs/webform).
+
+## Customizing with Layout Builder
+
+Beginning in [Website Services 10.3.1.1]({{% relref "release-ds-10.3.1.1.md" %}}) content editors have the option of customizing the Program Subcategory page with [Layout Builder](../../layout-builder). You can migrate from using Paragraphs to using Layout Builder on a program-by-program basis to ease the transition.
+
+The **Use Layout Builder** checkbox on the Program Subcategory edit page non-destructively switches between Paragraphs and Layout Builder. If the checkbox does not appear, ensure the **Y Program Subcategory** (`y_program_subcategory`) module is installed at **Admin** > **Extend** (`/admin/modules`).
+
+### Layout Builder Blocks
+
+Program Subcategory pages do not utilize any specialized blocks. See [Layout Builder](../../layout-builder) for the list of all components.
+
+### Migrating to Layout Builder
+
+Migrating Program pages to Layout Builder uses the same process as [building a new Landing Page](../../layout-builder/#creating-a-new-page). See [How to migrate to Layout Builder](../../../howto/migrate-to-lb/#prepare-your-content) for information about preparing for the migration.
diff --git a/content/en/docs/user-documentation/content-types/program/_index.md b/content/en/docs/user-documentation/content-types/program/_index.md
index 84a2b7538..5e003b9c2 100644
--- a/content/en/docs/user-documentation/content-types/program/_index.md
+++ b/content/en/docs/user-documentation/content-types/program/_index.md
@@ -71,3 +71,28 @@ For aside pieces of content, such as side navigations, promotional cards and con
 
 * The *Description* field always displays above the paragraphs you enter.
 * There is no bottom area for you to add an anchoring element.
+
+## Customizing with Layout Builder
+
+Beginning in [Website Services 10.3.1.1]({{% relref "release-ds-10.3.1.1.md" %}}) content editors have the option of customizing the Program page with [Layout Builder](../../layout-builder). You can migrate from using Paragraphs to using Layout Builder on a program-by-program basis to ease the transition.
+
+The **Use Layout Builder** checkbox on the Program edit page non-destructively switches between Paragraphs and Layout Builder. If the checkbox does not appear, ensure the **Y Program** (`y_program`) module is installed at **Admin** > **Extend** (`/admin/modules`).
+
+### Layout Builder Blocks
+
+Program pages can take advantage of the [Categories Listing](../../paragraphs/categories-listing) block to list child Program Subcategory pages. To add the block:
+
+- Click the **Layout** tab at the top of your page.
+- Scroll to the location on the page where you want to add the block (usually the **Body** section).
+- Click **Add block**.
+- In the sidebar, expand **All system blocks**.
+- Search for "Categories Listing" or scroll to **Lists (Views)** > **Categories Listing**.
+- Click on **Categories Listing**.
+- Check **Override title** to add a title to the block.
+- Click **Add block**.
+
+> NOTE: As of version 10.3.1.1 (December 2023) the **Categories Listing** block styles have not been updated to be in line with the [Design System](../../layout-builder/designs/#design-system). They will be updated as of the March 2024 release. Keep an eye on [y_program releases](https://www.drupal.org/project/y_program/releases) for details.
+
+### Migrating to Layout Builder
+
+Migrating Program pages to Layout Builder uses the same process as [building a new Landing Page](../../layout-builder/#creating-a-new-page). See [How to migrate to Layout Builder](../../../howto/migrate-to-lb/#prepare-your-content) for information about preparing for the migration.