← All playbooks · Raw API

publications-pages

# Publications — Headwater Science

Playbook for **publication articles** (`resources/publications`).

## URL patterns

```
/resources/publications/{presentation-type}/{slug}/
```

Examples: `/resources/publications/oral-presentation/negative-control-outcomes-to-assess-the-comparability-of/`

## Content stack

| Region | Type | Role |
|--------|------|------|
| Template | **Publications hero** | Title, citation (`subtitle`), authors, tags, external link |
| Optional | **Publication poster image** | Requires `download` + `poster-presentation` tag + `featuredImage` |
| `content` | **Publication rich text** only | Main body |

## Required / common fields

| Field | Guidance |
|-------|----------|
| `articleType` | `resources/publications` |
| `primaryTag` | `presentation-type` — matches URL segment |
| `authors` | Ordered Person links |
| `subtitle` | Citation line on hero |
| `externalLink` | DOI/journal — “View publication →” |
| `featuredImage` | Hero visual |
| `download` | Poster PDF when poster UI is used |

Shared display rules: Pedestal `ARTICLE_PATTERNS.md` (Headwater uses same site-common helpers).

## Workflow

1. Read `cms-edit://customer/articles`
2. `cms-edit index sync`
3. Create with `articleTypeSlug: resources/publications`
4. Set tags, authors, subtitle, images/download as needed
5. **Publication rich text** only in `content`
6. `preview urls` → `diff` → `save` → `task-publish-handoff`

## Out of scope

- News articles — `news-pages`

## Publish handoff

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