Skip to content

Commit f883dbc

Browse files
Merge pull request #209 from neuroglia-io/blog-sdk-ts-legacy
Added a blog post about the legacy branch of the TS SDK
2 parents 2688940 + 14c6420 commit f883dbc

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
title: Serverless Workflow TypeScript SDK Legacy
3+
author: Jean-Baptiste Bianchi
4+
date: 2024-08-09
5+
description: >
6+
Legacy Branch & Release for the TypeScript SDK
7+
---
8+
9+
# Announcing the Legacy Branch & release for Serverless Workflow TypeScript SDK
10+
11+
Hello, Serverless Workflow community!
12+
13+
I'm excited to share some important updates regarding the TypeScript SDK for the Serverless Workflow specification. As many of you know, our specification underwent a significant rewrite after version 0.9, culminating in the anticipated release of version 1.0.0-alpha. This update will bring many improvements and changes, aligning the spec with the latest needs and trends in serverless architectures.
14+
15+
## Introducing the Legacy Branch
16+
17+
For those of you who have been working with version 0.9 of the spec and wish to continue using it, we've created a **legacy branch** in our GitHub repository. This branch is for developers who want to maintain the older version, even though our organization will not officially support it moving forward.
18+
19+
You can find the legacy branch here: [Serverless Workflow TypeScript SDK - Legacy spec 0.9 Branch](https://github.com/serverlessworkflow/sdk-typescript/tree/legacy-spec-0.9)
20+
21+
### NPM Package for the Legacy Version
22+
23+
The legacy branch is published under the previously erroneous organization name `@severlessworkflow`. This package is available for those needing the older version for compatibility reasons and is aligned with version 0.9 of the specification.
24+
25+
To install the legacy package, you can use:
26+
27+
```bash
28+
npm install @severlessworkflow/[email protected]
29+
```
30+
31+
This package will retain the older naming and organizational structure to maintain backward compatibility for existing projects.
32+
33+
## Upcoming Packages with Correct Naming
34+
35+
Moving forward, all new packages will be released under the correct (organization) name `@serverlessworkflow/sdk`. This change not only corrects a previous error but also aligns with the updated versioning of the spec.
36+
37+
The version 1.0.0-alpha is still a [work in progress](https://github.com/serverlessworkflow/sdk-typescript/pull/188). It will be released once it is ready and will feature all the enhancements and updates introduced with the rewritten specification.
38+
39+
## Why This Matters
40+
41+
These changes ensure consistency and alignment with our community's expectations and standards. Maintaining a legacy branch provides a bridge for developers needing more time to transition to the new specification. At the same time, the correct naming and versioning for new packages help streamline our offerings and reduce confusion.
42+
43+
## Moving Forward
44+
45+
We encourage all developers to explore the new features and improvements of the upcoming SDK version once it is released. For those who need to stick with the older version for now, the legacy branch is there for your convenience.
46+
47+
Thank you for your continued support and contributions to the Serverless Workflow community. As always, your feedback is invaluable, and we look forward to hearing your thoughts on these changes.
48+
49+
Happy coding!

0 commit comments

Comments
 (0)