Skip to content

Commit 5c3fc19

Browse files
committed
docs: resolve Forms/Forms Lab relationship — separate but linked
Both are standalone featured items. Cross-linked via `related` field on detail pages and placed adjacent in the home grid. Promote related field from stretch to main implementation sequence.
1 parent d951009 commit 5c3fc19

1 file changed

Lines changed: 16 additions & 11 deletions

File tree

docs/featured-content.md

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ Featured repos get a subtle highlight (accent border, background tint) but stay
105105

106106
Each featured repo already gets a full detail page from the existing `WorkDetail` template. No structural change needed there. But consider:
107107

108-
- **Cross-linking between featured projects.** If Forms and Forms Lab are related, a "Related projects" section at the bottom of each detail page would help visitors discover the family. This can be driven by a `related: [forms-lab]` field in the overlay front-matter.
108+
- **Cross-linking between related projects.** Forms and Forms Lab should cross-link on their detail pages via a "Related projects" section. Driven by a `related: [forms-lab]` field in overlay front-matter. This is low-cost and makes the relationship explicit without conflating the two.
109109
- **"Back to featured" breadcrumb vs. "Back to all work."** Since featured repos are *part of* the catalog, the breadcrumb should go to `/work/` (the full index), not to a separate featured page. This reinforces the "same collection" principle.
110110

111111
---
@@ -128,15 +128,20 @@ Each featured overlay should communicate:
128128

129129
---
130130

131-
## What "Forms Lab" is relative to "Forms"
131+
## Forms and Forms Lab: linked but separate
132132

133-
This needs clarification for content purposes:
133+
Forms and Forms Lab are **separate featured items** — each gets its own card, detail page, and overlay. But they should be visibly linked so visitors understand the relationship.
134134

135-
- If Forms Lab is an **experimental playground** (try components, submit designs), it should be positioned as a companion/sandbox — "where agencies experiment before committing to Forms."
136-
- If it's a **documentation/demo site**, it's more of a resource than a product — maybe not "featured" on its own but linked from the Forms detail page.
137-
- If it's a **separate product** (different use case, different audience), it deserves its own full overlay with distinct positioning.
135+
### How to surface the link
138136

139-
The layout accommodates any of these — the question is purely content/positioning.
137+
| Mechanism | Where it appears | Effort |
138+
|-----------|-----------------|--------|
139+
| **`related` field in overlay front-matter** | Detail page — "Related projects" section at bottom | New field + render logic |
140+
| **Explicit mention in body copy** | Detail page body (e.g. "See also [Forms Lab](/work/forms-lab/)") | Zero code, just content |
141+
| **Shared "family" tag or badge** | Cards and detail pages | New taxonomy concept — probably overkill |
142+
| **Adjacent placement in featured grid** | Home page | Just ordering, no code |
143+
144+
**Recommendation:** Use the `related` front-matter field (planned for stretch anyway) to cross-link them on detail pages, and place them adjacent in the featured grid on the home page. The body copy can also reference the sibling naturally. This gives multiple touchpoints without introducing new taxonomy.
140145

141146
---
142147

@@ -178,20 +183,20 @@ No dead ends. Featured content is always reachable from the catalog, and the cat
178183
## Implementation sequence
179184

180185
1. **Rename:** `content/work/messaging.md``content/work/flexion-notify.md` (update title/summary to reflect repo name if needed).
181-
2. **Content:** Write `content/work/forms-lab.md`. Add `highlights` field to all four overlays.
186+
2. **Content:** Write `content/work/forms-lab.md`. Add `highlights` field to all four overlays. Add `related` field to Forms and Forms Lab overlays.
182187
3. **Overrides:** Mark all four repos as `featured: true`, `tier: active`, `category: product` in `overrides.yml`.
183188
4. **Refresh:** Trigger manual catalog refresh (or wait for daily run) once repos are public, to populate `repos.json`.
184189
5. **Component:** Build `FeaturedCard` component (or extend `RepoCard` with a `variant` prop).
185-
6. **Home page:** Wire `FeaturedCard` into the existing `home-featured__grid`.
190+
6. **Home page:** Wire `FeaturedCard` into the existing `home-featured__grid`. Place Forms and Forms Lab adjacent.
186191
7. **Work index:** Add section heading logic for featured cluster.
187-
8. **Stretch:** Add `related` field support and render cross-links on detail pages.
192+
8. **Related projects:** Add `related` field support to overlay front-matter and render cross-links on detail pages (needed for Forms ↔ Forms Lab link).
188193

189194
---
190195

191196
## Open questions
192197

193198
1. ~~Are the repos going to be public?~~ **Resolved** — yes, all going public. Approach A confirmed.
194-
2. What is Forms Lab's relationship to Forms — companion sandbox, docs site, or independent product?
199+
2. ~~Forms Lab's relationship to Forms?~~ **Resolved** — separate featured items, but linked visibly (cross-links on detail pages, adjacent in grid).
195200
3. Should the featured section on the home page have its own heading/intro copy, or just the grid?
196201
4. Do we want a cap on featured projects (e.g., max 6) to protect the home page layout?
197202
5. For the `highlights` field — should these be auto-derived from the overlay body, or always hand-authored?

0 commit comments

Comments
 (0)