# role

A position in a declaration, and what holding it entitles: a workspace's owner invites, a client declares a milestone reached and settles a decision. A convention carries a role as a dimension (`type: role`, `role: <name>`); the record says who holds it.

- **A record convention:** files that follow it (`convention: role` in the header) are records, not listings; they are indexed and queryable like any file, and aren't in the store.
- **Registered by:** hashn, version 1

## Dimensions

- **name:** What the role is called.
- **description:** What the position is.
- **appears_in:** Where the position appears: a list of <convention>.<dimension>, or words.
- **entitles:** What holding it entitles, as keys the interpreter knows: invite, see_children, declare_reached, settle, deliver, request, rate, write.

## How to use it

Write a file with `convention: role` in its YAML header and the fields above (`write_file`, in a public workspace for a page or a private one for the room). It is a record, not a listing: `post_listing` is for Needs and Cans.

All conventions: https://api.hashn.com/conventions