← All playbooks · Raw API

articles

# Articles — Pedestal Health


## Source packages (briefs, Drive, assets)

Before creating from an external brief or asset pack:

1. Follow **`task-source-readiness-review`** (inventory → beat sheet → GO / GO-WITH-GAPS / NO-GO → light human yes).
2. Map structure **faithfully** to this site's components — **do not rewrite source copy**.
3. Do not invent pair layouts or section titles absent from the source.
4. Prefer source order; use labeled placeholders when the verdict is GO-WITH-GAPS.

Routing and shared rules for **news** and **publications**. Use specialized playbooks for create/edit workflows:

| Article family | Playbook |
|----------------|----------|
| Press / news items | `cms-edit://customer/news-pages` |
| News portrait + OG images | `cms-edit://customer/news-images` |
| Publications, posters, manuscripts | `cms-edit://customer/publications-pages` |

## Article types

| Article type slug | Use for |
|-------------------|---------|
| `resources/news` | Press releases, news items, conference coverage |
| `resources/publications` | Publications, posters, manuscripts |

```bash
cms-edit list --type articleType
cms-edit index sync
```

## URL shape

Articles use **primary tag in the path** (`enablePrimaryTagPartOfSlug` is on):

```
/resources/{articleTypeSlug}/{primaryTopic}/{slug}/
```

Examples:

- `/resources/publications/poster-presentation/fibrosis-assessed-by-non-invasive-tests-is-similar-to-liver/`
- `/resources/news/press-release/{slug}/`

Tag-only listing URLs (no article slug) also exist under `/resources/news/{tag}/` and `/resources/publications/{tag}/`.

## Primary tag rules

| Article type | Primary tag from tag type |
|--------------|---------------------------|
| `resources/news` | `asset-type` |
| `resources/publications` | `presentation-type` |

Pick the primary tag that matches the listing URL editors expect. Use `cms-edit list --type tag` after `index sync`.

## Shared article fields

| Field | Notes |
|-------|-------|
| `articleType` | Required — link to `resources/news` or `resources/publications` |
| `title` | Headline |
| `slug` | URL segment (lowercase, hyphenated) |
| `date` | Publication date |
| `description` | Meta description |
| `authors` | Ordered array of Person links — **prefer over legacy `author`** |
| `tags` | Topic, partner, conference, TA filters |
| `subtitle` | Display line below title (news blocks; citation on publications) |
| `summary` | RTF; publications may include `Partners: …` line |
| `content` | Article body components only — see specialized playbooks |

## Listing and discovery

```bash
cms-edit list --type article --sort date -n 20
cms-edit open --article-slug <slug>
cms-edit peek --article-slug <slug>
```

Fetch markdown: append `.md` to the public HTML path.

## Site default featured image

When no custom OG image: `featuredImageAssetId` in `project.json` (`6vN4Yu2yEKYUhe8xId6xmP`). Resolve after `index sync`.

## Full technical reference

- `apps/pedestal-website/src/project/ARTICLE_PATTERNS.md` — hero preview, display fields, poster rules
- `apps/pedestal-website/docs/cms-edit-pedestal.md` — timeline → publication link mapping

## Publish handoff

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