Document
One piece of content in a Collection: a page, a post, a docs article, a changelog entry or a help article, in Markdown, with a status from draft to published, authors, SEO metadata and an optional parent for hierarchies.
| Pack | Content |
| Version | v1 (latest) |
| URN | urn:postware:content:document |
| Identity | collection + slug + locale |
| Status categories | draft, review, published, archived |
Fields
| Field | Type | Req | Notes |
|---|---|---|---|
collection | Ref<Collection> | yes | |
title | string | yes | |
slug | string | yes | pattern ^[a-z0-9]+(-[a-z0-9]+)*$ |
body | text | no | Markdown; a source's native rich text stays in source.payload |
summary | text | no | |
status | Status(draft| | yes | default map[category:draft] |
published_at | datetime | no | set by the server on the first transition to published when absent; a future value schedules |
authors | Ref<Member | | yes | at least one |
cover | Ref<File> | no | |
seo | SEO | no | |
locale | string | no | BCP 47 |
parent | Ref<Document> | no | docs hierarchy |
order | int | no |
Events
document.published when status.category becomes published.