23 lines
1.2 KiB
Markdown
23 lines
1.2 KiB
Markdown
|
# portal documentation
|
||
|
|
|
||
|
|
Portal turns a Git repo of YAML into a running site. Almost everything
|
||
|
|
here is about that YAML: what a content repo may say, and what the
|
||
|
|
engine does with it.
|
||
|
|
|
||
|
|
| | |
|
||
|
|
|---|---|
|
||
|
|
| [Architecture](architecture.md) | What the engine is made of and where each piece lives in the source. |
|
||
|
|
| [Content reference](content-reference.md) | Every key a content repo may write, and what it does. |
|
||
|
|
| [State machines](state-machines.md) | `aggregates.yaml`: stages, who moves a case, mail, deadlines, memberships. |
|
||
|
|
| [Access](access.md) | How the Cedar policy is compiled from content, and who may ask it what. |
|
||
|
|
| [Operations](operations.md) | Releasing, deploying, adding a site, environment variables. |
|
||
|
|
| [Filesystem routes](design/filesystem-routes.md) | Why the `questions/` tree is the router. |
|
||
|
|
|
||
|
|
Two repos in the same family carry their own docs:
|
||
|
|
|
||
|
|
- [uhhm/iris](https://project.uhhm.no/uhhm/iris) — the lint. Versioned
|
||
|
|
as portal and released by portal's publish job; it is the thing a
|
||
|
|
content repo's CI runs before anything reaches a site.
|
||
|
|
- [uhhm/gdo](https://project.uhhm.no/uhhm/gdo) — the mailer. Delivers
|
||
|
|
what content asked to be sent, and carries replies back.
|