Folio Assistant Core

Process

Authoring a document

https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring

JSON-LD · diagram · in graph folio-assistant-core.jsonld ·

nameAuthoring a document
summaryHow a document folio — structured prose and policy guidance, with no Lean and no required TeX — is authored, built and reviewed end to end.
descriptionHow 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.
enforcementadvisory
sourcePathcollab/processes/content/authoring-a-document.bpmn
sourceUrlhttps://github.com/litlfred/folio-assistant-core/blob/main/collab/processes/content/authoring-a-document.bpmn
depictionhttps://litlfred.github.io/folio-assistant/assets/img/workflows/authoring-a-document.svg
startNodeNew document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/StartEvent_NewDocument
nodeCount17
flowCount18
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

Flows

flow/A01

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromNew document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/StartEvent_NewDocument
toPlan the document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Plan
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A02

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromPlan the document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Plan
toOpen the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanOpen
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A03

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromOpen the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanOpen
toBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_BeanYours
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A04

nameclaimed
partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_BeanYours
toSeed the work plan
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_SeedPlan
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A05

namenot yours
partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_BeanYours
toNot yours: left alone
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/End_BeanNotYours
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A06

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromSeed the work plan
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_SeedPlan
toScaffold the folio
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Scaffold
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A07

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromScaffold the folio
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Scaffold
toAuthor blocks
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A08

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromAuthor blocks
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks
toCheck the profile
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_ProfileCheck
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A09

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromCheck the profile
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_ProfileCheck
toWithin the declared profile?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Gateway_ProfileClean
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A10

nameviolations
partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromWithin the declared profile?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Gateway_ProfileClean
toAuthor blocks
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A11

nameclean
partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromWithin the declared profile?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Gateway_ProfileClean
toValidate
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Validate
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A12

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromValidate
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Validate
toPublish extracted statements
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_PublishStatements
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A12b

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromPublish extracted statements
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_PublishStatements
toRender MD, HTML and PDF
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Render
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A13

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromRender MD, HTML and PDF
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_Render
toReview and publish
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_ReviewPublish
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A14

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromReview and publish
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_ReviewPublish
toPublished?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_Published
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A15

nameyes
partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromPublished?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_Published
toClose the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanClose
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A16

partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromClose the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Call_BeanClose
toDocument published
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/EndEvent_Published
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/A17

nameno
partOfAuthoring a document
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring
fromPublished?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/GW_Published
toAuthor blocks
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_DocumentAuthoring/node/Task_AuthorBlocks
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab