# Publications — Pedestal Health

Playbook for **publication articles** (`resources/publications`) — manuscripts, posters, abstracts, and conference presentations.

## URL patterns

| Pattern | Examples |
|---------|----------|
| `/resources/publications/{primaryTopic}/{slug}/` | `/resources/publications/poster-presentation/time-to-disease-progression-and-all-cause-mortality-in/` |
| `/resources/publications/{tag}/` | Tag listing index (taxonomy-driven) |
| `/resources/publications/` | Article type landing |

Primary topic comes from **presentation-type** tag (e.g. `poster-presentation`, `abstract-manuscript`, `oral-presentation`).

## Typical content stack

Publication detail pages use the **resources/publications** article type template — do not duplicate hero blocks in `content`.

| Region | Type | Role |
|--------|------|------|
| Template hero | **Publications hero** (article-sourced) | Title, subtitle (citation), authors, tags, partners line, external link |
| Poster (optional) | **Publication poster image** | Thumbnail + download — requires `download` asset |
| Body | **Publication rich text** | Main article copy |

**`content` should contain Publication rich text only** — hero fields come from the article entry and template.

## Required / common fields

| Field | Guidance |
|-------|----------|
| `articleType` | `resources/publications` |
| `title` | Publication title |
| `subtitle` | Citation line on hero |
| `summary` | RTF; may include `Partners: …` (shown on hero) |
| `authors` | Ordered Person links — primary author first |
| `tags` | Publication source, conference/venue, therapeutic area |
| `primaryTag` | Presentation type — **must match URL segment** |
| `featuredImage` | Hero visual / poster thumbnail |
| `externalLink` | DOI or journal URL — “View publication →” on hero |
| `download` | Poster PDF asset when **Publication poster image** is used |

## Poster presentations

All three are required for poster UI:

1. `featuredImage` — poster thumbnail
2. `download` — PDF asset
3. Tag `poster-presentation` (and matching primary tag for URL)

## Reference publications

| Path | Clone when |
|------|------------|
| `/resources/publications/poster-presentation/fibrosis-assessed-by-non-invasive-tests-is-similar-to-liver/` | Poster + body |
| `/resources/publications/abstract-manuscript/cardiovascular-risk-assessment-tools-are-insufficient-for/` | Manuscript abstract |
| `/resources/publications/oral-presentation/use-of-glucagon-like-peptide-1-receptor-agonists-in/` | Oral presentation |

Fetch markdown: `https://www.pedestalhealth.com/resources/publications/poster-presentation/fibrosis-assessed-by-non-invasive-tests-is-similar-to-liver.md`

Disease-area **Timeline** links often point at publication URLs — see mapping table in `apps/pedestal-website/docs/cms-edit-pedestal.md`.

## Workflow

1. Read `cms-edit://customer/articles` for routing and tag rules
2. `cms-edit index sync` — resolve article types, tags, default featured image
3. `task-create-article` or `create from-json` with `articleTypeSlug: resources/publications`
4. Set `primaryTag` / tags to match intended URL (`presentation-type`)
5. Set `authors`, `subtitle`, `externalLink`, `featuredImage` (+ `download` for posters)
6. Add **Publication rich text** to `content` only
7. `create from-json --dry-run --strict` before save
8. `preview urls` on staging → `diff` → `save` → `task-publish-handoff`

## Out of scope

- **News** articles — use `news-pages`
- Creating duplicate **Publications hero** components in `content`
- Changing tag listing page layout — edit tags or article type config

## Publish handoff

`save` creates drafts only — publish in Contentful UI when ready.