Release Process

Prepare Noema changes for review, release, and maintenance.

Use this checklist before publishing meaningful Noema changes.

Version and Scope

For each release or major update, identify:

  • The feature or behavior being changed.
  • The owning package or plugin.
  • The verification commands that passed.
  • Any migration or configuration notes developers need.

Pre-Release Checklist

pnpm lint
pnpm build

Also check:

  • Screenshots for visible UI changes.
  • Links to renamed files or moved pages.
  • Examples for stale environment variables or provider names.

Changelog Notes

For meaningful changes, include:

  • Added capabilities.
  • Updated concepts or runtime behavior.
  • Removed obsolete setup instructions.
  • Known gaps that remain.

Rollback

If a published change is wrong, prefer a forward fix when the issue is small and contained. Revert when the change breaks core workflows, exposes secrets, or misleads developers.

On this page