Search⌘K

Who can publish 'What's New' release notes that everyone sees?

Who can publish platform-wide release-note / announcement posts.

Only a platform Super Admin (the ZiplineOS team) can publish a "What's New" release note. Once published, that single post appears for every user across every organisation.

What a "What's New" note is

A release note is a short post announcing a change — new feature, bug fix, improvement, or broader announcement. Each note has a title, a version, and a Markdown body. Because notes are platform-wide, they are locked down to the people who run the platform.

Who can do what

ActionWho can do it
Read published notes and mark them readAny logged-in user
Browse the full changelogAny logged-in user
Create, edit, publish, re-push, or delete a notePlatform Super Admin only
See draft notesPlatform Super Admin only
Auto-draft notes from a deployThe ZiplineOS release pipeline

"Super Admin" means the top-level platform role held by the ZiplineOS team — not an org Owner or Admin. Being an Admin inside your company account does not let you publish platform-wide notes.

A note has two states: draft and published. A draft stays hidden until a Super Admin hits Publish, which stamps the publish date and releases it to everyone.

How notes usually get written

Most release notes start automatically. When the ZiplineOS team ships a deploy, the release pipeline reads the change and drafts candidate notes (Feature, Bug Fix, Improvement, or Announcement). That step can run under a scoped automation key.

But a draft is just a draft — publishing, editing, and deleting always require a human Super Admin. Even AI-assisted drafts get a person's review before anyone sees them.

Spotted something worth announcing, or an error in a published note? You can't edit it yourself — flag it to the ZiplineOS team and a Super Admin can handle it.

Why it's locked down

A "What's New" note reaches every account at once. Restricting create/publish/delete to Super Admins keeps the channel trustworthy and prevents misuse. Everyone else can still read every published note — they just can't write to the shared feed.

Where to learn more

  • Changelog — the running history of published ZiplineOS releases.