@commercengine/storefront-sdk 0.4.7 → 0.5.0

package/README.md

@@ -407,6 +407,57 @@ The SDK implements CommerceEngine API best practices automatically:
 - ✅ **Timeout handling** with configurable limits
 - ✅ **Memory leak prevention** with proper cleanup
 
+## Contributing
+
+### Version Management with Changeset
+
+This project uses [Changeset](https://github.com/changesets/changesets) for version management and publishing. Here's how to contribute:
+
+#### Creating Changes
+
+When you make changes to the SDK, create a changeset to document them:
+
+```bash
+pnpm changeset
+```
+
+This will prompt you to:
+- Select the type of change (patch/minor/major)
+- Write a summary of what changed
+- Create a markdown file in the `.changeset/` folder
+
+#### Version Types
+
+- **Patch** (0.0.x): Bug fixes, documentation updates, internal refactoring
+- **Minor** (0.x.0): New features, new API endpoints, backwards-compatible changes  
+- **Major** (x.0.0): Breaking changes, API modifications that affect existing code
+
+#### Release Process
+
+1. **During Development**: Create changesets for your changes
+   ```bash
+   pnpm changeset
+   ```
+
+2. **Before Release**: Consume changesets and update versions
+   ```bash
+   pnpm version
+   ```
+   This updates `package.json`, generates/updates `CHANGELOG.md`, and removes consumed changesets.
+
+3. **Publishing**: Build and publish to npm
+   ```bash
+   pnpm release
+   ```
+
+#### Available Scripts
+
+- `pnpm changeset` - Create a new changeset
+- `pnpm version` - Consume changesets and bump version  
+- `pnpm release` - Build and publish to npm
+
+The changeset workflow ensures proper semantic versioning, comprehensive changelogs, and coordinated releases.
+
 ## License
 
-This project is licensed under the MIT License.
+All Rights Reserved