← All playbooks · Raw API

articles

# Resource articles — Highlander Health

Playbook for **Mosaic Medicine** and other **resource** articles.

## URL patterns

| Public path | Entry | Notes |
|-------------|-------|-------|
| `/resources/` | Page + **Articles** collection | Type index (`enableArticleTypeIndex`, `ARTICLES_BASE=/resources`) |
| `/resource/{slug}/` | Article | Detail URL is **`/resource/`** (singular), not `/resources/{slug}/` |
| `/resources/{type}/` | Article type index | Primary type slug is `resource` |

Tags: `/tags/` index; tag pages follow site routing. Primary tag is **not** part of the article slug (`enablePrimaryTagPartOfSlug` is false).

## When to use

- New or updated resource / Mosaic Medicine articles
- Changing title, date, tags, icon, featured image, or body stack

Read `cms-edit://customer/routing` first. Live markdown: `https://www.highlanderhealth.com/resource/{slug}.md` (Bond) or Vercel/localhost equivalents.

## Clone references

Peek published articles from the `/resources/` listing. Typical stack:

| Region | Type | Role |
|--------|------|------|
| Title / chrome | Article fields + template | Not a marketing **Hero** |
| Body | **Article Rich Text** | Main copy |
| Extra blocks | **Callout**, **Q&A Rich text**, **Image and Text** | Sparingly |

```bash
cms-edit peek --article-slug <slug>
```

## Fields

- `articleType`: **resource** (listing lives under `/resources/`)
- `slug`: public `/resource/{slug}/`
- Title, date, tags (`Resource category` and others as used on live entries)
- Icon / featured image for cards and social
- Authors via Person links when present

## Workflow

1. Read `cms-edit://customer/tasks-index` → `task-create-article` or open existing article
2. Follow `task-source-readiness-review` for external briefs
3. Set type, slug, SEO fields, featured image
4. Edit body components — keep **Article Rich Text** for long copy
5. `preview urls` → `diff` → `save` → `task-publish-handoff`

## Related playbooks

- Hub listing page `/resources/` — `pages.md`
- Person authors — `people.md`