Folio Assistant Core

Process

Content Change and Review

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

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

nameContent Change and Review
summaryGetting a change to a folio's CONTENT from a request into a published rendering: the author says what they want, an agent works out its scope and makes it, a review committee accepts or refuses it, and the pipeline deploys.
descriptionGetting a change to a folio's CONTENT from a request into a published rendering: the author says what they want, an agent works out its scope and makes it, a review committee accepts or refuses it, and the pipeline deploys. You are in this process when what is changing is a folio — a chapter, a block, a piece of deterministic logic — rather than the platform that renders it. code-change-review is the same shape for the platform: a content change is accepted by a REVIEW COMMITTEE on editorial grounds, a platform change by a code reviewer on engineering ones. Two things this is not. It is not the feedback workflow: todo-review triages what readers said about content that already exists. And the rendering the author reviews is a STAGED one, because a person cannot assess a rendered artefact from a description of it. The diagram shows the phases and the hand-offs between them; each phase is its own process. Making the change is content-change-review-make, staging it is content-change-review-stage, the committee's review is content-change-review-committee, and merging and deploying is content-change-review-publish. This follows bpmn-authoring's rule of one phase per call activity.
enforcementstrict
sourcePathcollab/processes/content/content-change-review.bpmn
sourceUrlhttps://github.com/litlfred/folio-assistant-core/blob/main/collab/processes/content/content-change-review.bpmn
depictionhttps://litlfred.github.io/folio-assistant/assets/img/workflows/content-change-review.svg
startNodeAuthor requests content change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Start_Author
nodeCount17
flowCount18
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

Flows

flow/f1

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromAuthor requests content change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Start_Author
toDescribe the desired change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_DescribeChange
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/f2

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromDescribe the desired change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_DescribeChange
toOpen the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanOpen
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_2

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromOpen the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanOpen
toBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_BeanYours
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_3

namenot yours
partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_BeanYours
toNot yours — left alone
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/End_BeanNotYours
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_1

nameclaimed
partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_BeanYours
toMake the change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_MakeChange
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/a7

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromMake the change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_MakeChange
toStage the change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_StageChange
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/p4b

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromStage the change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_StageChange
toReview staged rendering
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_ReviewStaging
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/f3

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromReview staged rendering
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_ReviewStaging
toSatisfied with changes?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_AuthorSatisfied
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/f4

nameNo
partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromSatisfied with changes?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_AuthorSatisfied
toRequest further revisions
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_RequestRevision
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/f5

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromRequest further revisions
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_RequestRevision
toIterate on author feedback
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_Iterate
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/flow_iterate_to_pipeline

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromIterate on author feedback
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_Iterate
toStage the change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_StageChange
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/f6

nameYes
partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromSatisfied with changes?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_AuthorSatisfied
toSubmit to review committee
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_SubmitForReview
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/flow_submit_to_reviewer

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromSubmit to review committee
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_SubmitForReview
toReview the change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_CommitteeReview
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/r3

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromReview the change
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_CommitteeReview
toApproved?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_CommitteeApproved
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/r5

namechanges requested
partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromApproved?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_CommitteeApproved
toIterate on author feedback
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_Iterate
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/r6

nameapproved
partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromApproved?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_CommitteeApproved
toMerge and publish
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_Publish
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/p7b

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromMerge and publish
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_Publish
toClose the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanClose
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_4

partOfContent Change and Review
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
fromClose the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanClose
toChange closed
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/End_Agent
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab