You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
Copy file name to clipboardExpand all lines: docs/featured-content.md
+16-11Lines changed: 16 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -105,7 +105,7 @@ Featured repos get a subtle highlight (accent border, background tint) but stay
105
105
106
106
Each featured repo already gets a full detail page from the existing `WorkDetail` template. No structural change needed there. But consider:
107
107
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.
109
109
-**"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.
110
110
111
111
---
@@ -128,15 +128,20 @@ Each featured overlay should communicate:
128
128
129
129
---
130
130
131
-
## What "Forms Lab" is relative to "Forms"
131
+
## Forms and Forms Lab: linked but separate
132
132
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.
134
134
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
138
136
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.
140
145
141
146
---
142
147
@@ -178,20 +183,20 @@ No dead ends. Featured content is always reachable from the catalog, and the cat
178
183
## Implementation sequence
179
184
180
185
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.
182
187
3.**Overrides:** Mark all four repos as `featured: true`, `tier: active`, `category: product` in `overrides.yml`.
183
188
4.**Refresh:** Trigger manual catalog refresh (or wait for daily run) once repos are public, to populate `repos.json`.
184
189
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.
186
191
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).
188
193
189
194
---
190
195
191
196
## Open questions
192
197
193
198
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).
195
200
3. Should the featured section on the home page have its own heading/intro copy, or just the grid?
196
201
4. Do we want a cap on featured projects (e.g., max 6) to protect the home page layout?
197
202
5. For the `highlights` field — should these be auto-derived from the overlay body, or always hand-authored?
0 commit comments