Process
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview
JSON-LD · diagram · in graph folio-assistant-core.jsonld ·
| name | Content Change and Review |
|---|---|
| summary | Getting 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. |
| description | Getting 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. |
| enforcement | strict |
| sourcePath | collab/processes/content/content-change-review.bpmn |
| sourceUrl | https://github.com/litlfred/folio-assistant-core/blob/main/collab/processes/content/content-change-review.bpmn |
| depiction | https://litlfred.github.io/folio-assistant/assets/img/workflows/content-change-review.svg |
| startNode | Author requests content change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Start_Author |
| nodeCount | 17 |
| flowCount | 18 |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Author requests content change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Start_Author |
| to | Describe the desired change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_DescribeChange |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Describe the desired change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_DescribeChange |
| to | Open the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanOpen |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Open the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanOpen |
| to | Bean claimed? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_BeanYours |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | not yours |
|---|---|
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
| from | Bean claimed? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_BeanYours |
| to | Not yours — left alone https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/End_BeanNotYours |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | claimed |
|---|---|
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
| from | Bean claimed? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_BeanYours |
| to | Make the change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_MakeChange |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Make the change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_MakeChange |
| to | Stage the change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_StageChange |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Stage the change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_StageChange |
| to | Review staged rendering https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_ReviewStaging |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Review staged rendering https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_ReviewStaging |
| to | Satisfied with changes? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_AuthorSatisfied |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | No |
|---|---|
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
| from | Satisfied with changes? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_AuthorSatisfied |
| to | Request further revisions https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_RequestRevision |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Request further revisions https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_RequestRevision |
| to | Iterate on author feedback https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_Iterate |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Iterate on author feedback https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_Iterate |
| to | Stage the change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_StageChange |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | Yes |
|---|---|
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
| from | Satisfied with changes? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_AuthorSatisfied |
| to | Submit to review committee https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_SubmitForReview |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Submit to review committee https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_SubmitForReview |
| to | Review the change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_CommitteeReview |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Review the change https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_CommitteeReview |
| to | Approved? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_CommitteeApproved |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | changes requested |
|---|---|
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
| from | Approved? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_CommitteeApproved |
| to | Iterate on author feedback https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Task_Iterate |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| name | approved |
|---|---|
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
| from | Approved? https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/GW_CommitteeApproved |
| to | Merge and publish https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_Publish |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Merge and publish https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_Publish |
| to | Close the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanClose |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |
| partOf | Content Change and Review https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview |
|---|---|
| from | Close the bean https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/Call_BeanClose |
| to | Change closed https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_ContentChangeReview/node/End_Agent |
| inSubgraph | collab https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab |