Process
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
JSON-LD · diagram · in graph folio-assistant-core.jsonld ·
| name | Authoring a document |
|---|---|
| summary | How a document folio — structured prose and policy guidance, with no Lean and no required TeX — is authored, built and reviewed end to end. |
| description | How a document folio — structured prose and policy guidance, with no Lean and no required TeX — is authored, built and reviewed end to end.
Source of truth: this file. The SVG under docs/assets/img/workflows/ is generated
from it by bun run cat render:bpmn — never hand-edit the SVG.
The shape is the paper process minus the Lean lane and plus one step, the profile
check, which is what keeps a document folio publishable without either toolchain.
Review, publish and committee feedback are core's shared Process_FolioReviewPublish, called after rendering. Its no answer, changes asked, comes back to Task_AuthorBlocks. |
| enforcement | advisory |
| sourcePath | collab/processes/content/authoring-a-document.bpmn |
| sourceUrl | https://github.com/litlfred/folio-assistant-core/blob/main/collab/processes/content/authoring-a-document.bpmn |
| depiction | https://litlfred.github.io/folio-assistant/assets/img/workflows/authoring-a-document.svg |
| startNode | New document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/StartEvent_NewDocument |
| nodeCount | 17 |
| flowCount | 18 |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | New document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/StartEvent_NewDocument |
| to | Plan the document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Plan |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Plan the document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Plan |
| to | Open the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanOpen |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Open the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanOpen |
| to | Bean claimed? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_BeanYours |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | claimed |
|---|---|
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
| from | Bean claimed? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_BeanYours |
| to | Seed the work plan https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_SeedPlan |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | not yours |
|---|---|
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
| from | Bean claimed? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_BeanYours |
| to | Not yours: left alone https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/End_BeanNotYours |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Seed the work plan https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_SeedPlan |
| to | Scaffold the folio https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Scaffold |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Scaffold the folio https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Scaffold |
| to | Author blocks https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Author blocks https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks |
| to | Check the profile https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_ProfileCheck |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Check the profile https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_ProfileCheck |
| to | Within the declared profile? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Gateway_ProfileClean |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | violations |
|---|---|
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
| from | Within the declared profile? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Gateway_ProfileClean |
| to | Author blocks https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | clean |
|---|---|
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
| from | Within the declared profile? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Gateway_ProfileClean |
| to | Validate https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Validate |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Validate https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Validate |
| to | Publish extracted statements https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_PublishStatements |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Publish extracted statements https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_PublishStatements |
| to | Render MD, HTML and PDF https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Render |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Render MD, HTML and PDF https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Render |
| to | Review and publish https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_ReviewPublish |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Review and publish https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_ReviewPublish |
| to | Published? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_Published |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | yes |
|---|---|
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
| from | Published? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_Published |
| to | Close the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanClose |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
|---|---|
| from | Close the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanClose |
| to | Document published https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/EndEvent_Published |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | no |
|---|---|
| partOf | Authoring a document https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring |
| from | Published? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_Published |
| to | Author blocks https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |