Skip to content

Commit 70a11d5

Browse files
authored
Merge pull request #266 from serverlessworkflow/blog-sdk-go-4.0.0
Blog: Open Workflow SDK Go v4.0.0 release
2 parents d6f057a + e710417 commit 70a11d5

1 file changed

Lines changed: 90 additions & 0 deletions

File tree

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
---
2+
title: "Open Workflow SDK Go 4.0.0"
3+
author: "Ricardo Zanini"
4+
date: "2026-07-14"
5+
description: >-
6+
Open Workflow SDK Go 4.0.0 is here — the Go SDK moves to its new home under the Open Workflow Specification organization with a fresh module path and updated branding.
7+
---
8+
9+
## Announcing the Release of Open Workflow SDK Go 4.0.0
10+
11+
We are excited to announce **Go SDK 4.0.0**, the first release under the **Open Workflow Specification** organization. This release marks the project's transition from "Serverless Workflow" to **Open Workflow**, reflecting the broader scope of the specification.
12+
13+
👉 Full release notes: [GitHub – v4.0.0](https://github.com/open-workflow-specification/sdk-go/releases/tag/v4.0.0)
14+
15+
---
16+
17+
## What's New in 4.0.0?
18+
19+
This release focuses on the rebranding — there are **no API or schema changes** from the v3.x line. The specification conformance remains at **v1.0.0**.
20+
21+
### New GitHub Home
22+
23+
The SDK now lives at [github.com/open-workflow-specification/sdk-go](https://github.com/open-workflow-specification/sdk-go). GitHub redirects from the old URL are in place, so existing links and references to v3.x releases continue to work.
24+
25+
### Updated Go Module Path
26+
27+
The module path has changed to reflect the new organization:
28+
29+
```
30+
github.com/open-workflow-specification/sdk-go/v4
31+
```
32+
33+
### Updated Error Type URIs
34+
35+
Standard error type URIs now use the `open-workflow-specification.org` domain:
36+
37+
```
38+
https://open-workflow-specification.org/spec/1.0.0/errors/validation
39+
https://open-workflow-specification.org/spec/1.0.0/errors/authentication
40+
...
41+
```
42+
43+
---
44+
45+
## Migration Guide
46+
47+
Upgrading from v3.x is straightforward — update your imports and run `go get`:
48+
49+
1. Update your import paths:
50+
51+
```go
52+
// Before
53+
import "github.com/serverlessworkflow/sdk-go/v3/parser"
54+
import "github.com/serverlessworkflow/sdk-go/v3/impl"
55+
56+
// After
57+
import "github.com/open-workflow-specification/sdk-go/v4/parser"
58+
import "github.com/open-workflow-specification/sdk-go/v4/impl"
59+
```
60+
61+
2. Fetch the new module:
62+
63+
```bash
64+
go get github.com/open-workflow-specification/sdk-go/v4
65+
```
66+
67+
3. If your code references error type URIs (e.g., `https://serverlessworkflow.io/spec/1.0.0/errors/...`), update them to `https://open-workflow-specification.org/spec/1.0.0/errors/...`.
68+
69+
4. Run your tests to verify the transition:
70+
71+
```bash
72+
go test ./...
73+
```
74+
75+
---
76+
77+
## What's Next
78+
79+
The reference implementation continues to grow. Check out the [implementation roadmap](https://github.com/open-workflow-specification/sdk-go#implementation-roadmap) to see what's supported and where you can contribute.
80+
81+
---
82+
83+
## Community
84+
85+
The project remains under **CNCF** governance. Join us on the CNCF Slack in the `#open-workflow-sdk` channel to collaborate, ask questions, and contribute.
86+
87+
* Issues & feedback: [github.com/open-workflow-specification/sdk-go/issues](https://github.com/open-workflow-specification/sdk-go/issues)
88+
* Specification: [github.com/open-workflow-specification/specification](https://github.com/open-workflow-specification/specification)
89+
90+
Thank you to everyone who contributed to this milestone release!

0 commit comments

Comments
 (0)