Skip to content

Comments

Added docs for workflow versioning#5003

Merged
marcduiker merged 31 commits intodapr:v1.17from
acroca:workflow-versioning
Feb 24, 2026
Merged

Added docs for workflow versioning#5003
marcduiker merged 31 commits intodapr:v1.17from
acroca:workflow-versioning

Conversation

@acroca
Copy link
Member

@acroca acroca commented Jan 15, 2026

At the moment I just added the Go code, as it's the only SDK that supports it. We'll need to add more code examples as we add support.

@acroca acroca requested review from a team as code owners January 15, 2026 10:45
JoshVanL
JoshVanL requested changes Jan 15, 2026
View reviewed changes
acroca added 3 commits January 20, 2026 10:24
@acroca
Added docs for workflow versioning
f58729e 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca
Extended intro for versioning
a8747fd 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca
Added comments from PR review
c07c0bf 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca acroca force-pushed the workflow-versioning branch from 9f73980 to c07c0bf Compare January 20, 2026 09:33
@acroca acroca requested a review from JoshVanL January 20, 2026 13:18
WhitWaldo
WhitWaldo reviewed Jan 21, 2026
View reviewed changes
Copy link
Contributor

@WhitWaldo WhitWaldo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've got a few comments (mostly suggestion for rephrasing) as well

acroca added 2 commits January 21, 2026 12:25
@acroca
PR preview comments
dd46859 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca
Added python sample code for workflow versioning
af1ad30 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
acroca added 3 commits January 26, 2026 12:13
@acroca
Renamed example workflows to workflow
617fbaf 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca
Added cli examples for stalled workflows
745b8de 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca
Mention that checks can appear multiple times.
d1fc905 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca acroca requested review from JoshVanL and WhitWaldo January 26, 2026 11:20
@acroca
Addressed comments
59d2d87 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
@acroca acroca requested a review from alicejgibbons February 12, 2026 14:10
marcduiker
marcduiker requested changes Feb 13, 2026
View reviewed changes
@acroca
Addressed comments from @marcduiker
4bb6bbf 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
marcduiker
marcduiker approved these changes Feb 16, 2026
View reviewed changes
Copy link
Contributor

@marcduiker marcduiker left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

WhitWaldo and others added 3 commits February 19, 2026 15:20
@WhitWaldo
Reworked workflow versioning section to:
bc5160d 
- Reflect consistent naming: "patching" vs "named workflows"
- Reorder to put patching first and describe the documentation from the intended versioning approach as a whole (patch, named version to clean and refactor, loop).
- Clarify that the two are meant to be complementary and are compatible with one another
- Add .NET examples for patching and named workflows
- Modify named section to reflect that .NET takes a slightly different approach (and can't support like-named workflows).

Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo
Fixed typo and added link back to versioning section
9522a6d 
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@acroca
Merge pull request #1 from acroca/whit-wf-versioning
008f0a1 
Updated workflow versioning section
@WhitWaldo @marcduiker
Update daprdocs/content/en/developing-applications/building-blocks/wo…
c28dd57 
…rkflow/workflow-features-concepts.md

Co-authored-by: Marc Duiker <marcduiker@users.noreply.github.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
marcduiker
marcduiker approved these changes Feb 20, 2026
View reviewed changes
Copy link
Contributor

@marcduiker marcduiker left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@acroca
Fixed code samples for Go and Python
a4244c8 
Signed-off-by: Albert Callarisa <albert@diagrid.io>
msfussell
msfussell reviewed Feb 20, 2026
View reviewed changes
Copy link
Member

@msfussell msfussell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Versioning section to be put into a separate document and not into the features-concept. There needs to be a short overview features-concept topic and this then linked to a separate article.

@WhitWaldo
Split out workflow versioning to separate document, fixed typo in .NE…
0fbd563 
…T example, added link to .NET versioning SDK documentation, fixed link to Dapr CLI workflow reference. Added blurb to features-concepts to point to dedicated page.

Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo
Copy link
Contributor

WhitWaldo commented Feb 22, 2026

The Versioning section to be put into a separate document and not into the features-concept. There needs to be a short overview features-concept topic and this then linked to a separate article.

As soon as @acroca can give me push access on his fork again, I've got a pending PR locally that does this and fixes a few links.

@msfussell
Copy link
Member

msfussell commented Feb 22, 2026

@acroca - Please can you enable @WhitWaldo access to your PR?

@acroca
Copy link
Member Author

acroca commented Feb 23, 2026

Done right now

@marcduiker marcduiker added this to the 1.17 milestone Feb 23, 2026
@WhitWaldo
Copy link
Contributor

WhitWaldo commented Feb 23, 2026 •
edited
Loading

@acroca Could you please merge https://github.com/acroca/dapr-docs/tree/whit-versioning-2 into your PR?

@acroca
Copy link
Member Author

acroca commented Feb 23, 2026

Done

msfussell
msfussell reviewed Feb 23, 2026
View reviewed changes
Copy link
Member

@msfussell msfussell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few simply comments to fix

@msfussell
Copy link
Member

msfussell commented Feb 23, 2026

@acroca - PTAL

WhitWaldo and others added 12 commits February 23, 2026 12:08
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
fd2220b 
…rkflow/workflow-features-concepts.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
f08be8b 
…rkflow/workflow-features-concepts.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
5276121 
…rkflow/workflow-features-concepts.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
35e17af 
…rkflow/workflow-features-concepts.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
656d14c 
…rkflow/workflow-versioning.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
b11d7f1 
…rkflow/workflow-versioning.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
8cde7f1 
…rkflow/workflow-versioning.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
76595df 
…rkflow/workflow-versioning.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@WhitWaldo @msfussell
Update daprdocs/content/en/developing-applications/building-blocks/wo…
a8c5393 
…rkflow/workflow-versioning.md

Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Whit Waldo <whit.waldo@innovian.net>
@acroca
Merge branch 'v1.17' into workflow-versioning
0dff0b4
@msfussell
Merge branch 'v1.17' into workflow-versioning
de79c3e
@msfussell
Merge branch 'v1.17' into workflow-versioning
5591fbb
msfussell
msfussell reviewed Feb 24, 2026
View reviewed changes
...cs/content/en/developing-applications/building-blocks/workflow/workflow-features-concepts.md

{{< /tabpane >}}

### Versioning Process Guidance
Copy link
Member

@msfussell msfussell Feb 24, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would either put a link to this section on guidance from the ## Versioning overview, or move this into the [workflow/workflow-versioning.md] document at the start. It seems odd to keep this on the concepts section otherwise.

@marcduiker marcduiker merged commit f8bc6e2 into dapr:v1.17 Feb 24, 2026
4 checks passed
@acroca acroca deleted the workflow-versioning branch February 24, 2026 15:37
@WhitWaldo WhitWaldo mentioned this pull request Feb 24, 2026
Merged
7 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@msfussell msfussell msfussell left review comments

@marcduiker marcduiker marcduiker approved these changes

@JoshVanL JoshVanL JoshVanL approved these changes

@WhitWaldo WhitWaldo Awaiting requested review from WhitWaldo

@alicejgibbons alicejgibbons Awaiting requested review from alicejgibbons

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

1.17

Development

Successfully merging this pull request may close these issues.

6 participants

@acroca @WhitWaldo @msfussell @marcduiker @alicejgibbons @JoshVanL