From 26af35f0406ba8b768a1c9088e2d00232e8b0f4d Mon Sep 17 00:00:00 2001 From: Scott Mo Date: Thu, 19 Mar 2026 14:17:40 -0500 Subject: [PATCH] feat: layout docs integration --- .../generating-experience-lwr-site/SKILL.md | 21 ++++++++++++++++--- .../docs/configure-content-themeLayout.md | 2 +- .../docs/configure-content-view.md | 4 ++-- 3 files changed, 21 insertions(+), 6 deletions(-) diff --git a/skills/generating-experience-lwr-site/SKILL.md b/skills/generating-experience-lwr-site/SKILL.md index 2cc2d804..9757840d 100644 --- a/skills/generating-experience-lwr-site/SKILL.md +++ b/skills/generating-experience-lwr-site/SKILL.md @@ -120,17 +120,32 @@ Reference docs within the skill directory. Note that these are **local** and not **Steps** (Follow the steps sequentially. Do not skip any step before proceeding): -- [ ] Read and follow [handle-ui-components.md](docs/handle-ui-components.md) to add LWCs to LWR sites. +- [ ] Load and follow [handle-ui-components.md](docs/handle-ui-components.md) to add LWCs to LWR sites. - [ ] Load and follow [handle-component-and-region-ids.md](docs/handle-component-and-region-ids.md) to handle id generation -- [ ] Read and follow [configure-content-themeLayout.md](docs/configure-content-themeLayout.md) if a component has one of the following requirements: +- [ ] Load and follow [configure-content-themeLayout.md](docs/configure-content-themeLayout.md) if a component has one of the following requirements: - needs to be "sticky" and persistent across pages - is used as a theme layout +### Creating Page Layouts / Container Components + +**Steps** (Follow the steps sequentially. Do not skip any step before proceeding): + +- [ ] Load and follow [handle-ui-components.md](docs/handle-ui-components.md) + ### Creating Theme Layouts **Steps** (Follow the steps sequentially. Do not skip any step before proceeding): -- [ ] Read and follow strictly [configure-content-themeLayout.md](docs/configure-content-themeLayout.md). +- [ ] Check with user whether this new theme layout reuses an existing theme layout component or requires a new one. +- [ ] Load and follow [handle-ui-components.md](docs/handle-ui-components.md) if creating a new theme layout component. +- [ ] Load and follow [configure-content-themeLayout.md](docs/configure-content-themeLayout.md). +- [ ] Load and follow [configure-content-view.md](docs/configure-content-view.md) if need to apply theme layout to pages + +### Applying/Setting Theme Layouts + +**Steps** (Follow the steps sequentially. Do not skip any step before proceeding): + +- [ ] Load and follow [configure-content-view.md](docs/configure-content-view.md) ### Configuring Branding diff --git a/skills/generating-experience-lwr-site/docs/configure-content-themeLayout.md b/skills/generating-experience-lwr-site/docs/configure-content-themeLayout.md index 7822e192..b752d88e 100644 --- a/skills/generating-experience-lwr-site/docs/configure-content-themeLayout.md +++ b/skills/generating-experience-lwr-site/docs/configure-content-themeLayout.md @@ -130,7 +130,7 @@ When generating a new theme layout, ensure: - [ ] `urlName` uses lowercase with hyphens (V) - [ ] `title` is human-readable (V) - [ ] `sfdc_cms__theme/[THEME_API_NAME]/content.json` updated by appending a new `contentBody.layouts` mapping (VI) -- [ ] **CRITICAL**: Complete all the UUID generation steps. See `docs/handle-component-and-region-ids.md` +- [ ] **CRITICAL**: Complete all the UUID generation steps. See [handle-component-and-region-ids.md](docs/handle-component-and-region-ids.md) ## Purpose B: Editing Existing Theme Layouts diff --git a/skills/generating-experience-lwr-site/docs/configure-content-view.md b/skills/generating-experience-lwr-site/docs/configure-content-view.md index a7270079..1e492748 100644 --- a/skills/generating-experience-lwr-site/docs/configure-content-view.md +++ b/skills/generating-experience-lwr-site/docs/configure-content-view.md @@ -126,7 +126,7 @@ The route's `activeViewId` must match the view's directory name exactly. - [ ] Directory and `_meta.json` follow structure (see Directory Structure, _meta.json Structure) - [ ] `content.json` has all required fields (A.1) - [ ] Component structure correct with both regions (A.1) -- [ ] **CRITICAL**: Complete all the UUID generation steps. see `docs/handle-component-and-region-ids.md` +- [ ] **CRITICAL**: Complete all the UUID generation steps. see [handle-component-and-region-ids.md](docs/handle-component-and-region-ids.md) - [ ] `viewType` matches route's `routeType` (CRITICAL) ### PART B: OBJECT PAGES @@ -218,7 +218,7 @@ The route's `activeViewId` must match the view's directory name exactly. The `vi - [ ] `viewType` matches route's `routeType` for all three views (CRITICAL) - [ ] Component structure correct with both regions (see A.1) - [ ] SEO assistant configured correctly per view type (B.4) -- [ ] **CRITICAL**: Complete both UUID generation steps. see `docs/handle-component-and-region-ids.md` +- [ ] **CRITICAL**: Complete both UUID generation steps. see [handle-component-and-region-ids.md](docs/handle-component-and-region-ids.md) ## Purpose B: Editing Existing Views