techref: Pub tables and Workflows#2
Conversation
|
Perhaps stuffing a bit too much into one PR with this approach, but I think my commits are most helpfully viewed separately (rather than clicking the 'Files Changed' tab on the PR).
On the former, I opted for more verbose names as we get our bearing. On the latter, there are definitely some naming conventions that need to be worked out, and considerations I'm sure will come up in our next conversation. Like last time, you can pull this PR down, run |
| - Internal side effects: modify Pub metadata, but directly in the app | ||
| - External side effects: modify Pub metadata, but via an integration |
There was a problem hiding this comment.
This wasn't my understanding. My understanding was that integrations can cause either internal or external side-effects (perhaps both), and that those were defined as:
- Internal side effects: changes pub metadata
- External side-effects: triggers off-platform events.
The former is internal to our platform (e.g. edits the title, generates a new file, creates a review). The latter is external to our platform (e.g. builds a website, posts to slack, deposits to archival service).
|
|
||
| ### Workflows | ||
| - Integrations can be connected to any stage. | ||
| - Workflow stage actions generally shouldn't change Pub metadata — Pub metadata should be changed in side effects or integrations. |
There was a problem hiding this comment.
Reflecting the above comment, my understanding was that integrations cause side-effects (rather than them being two different ways of modifying metadata).
to reflect some clarifications on 06-26-23.

@djagdish @3mcd @kalilsn @howebenhowe @qweliant