Skip to content

Development Preview and Release Model

PlatanoGames edited this page Aug 8, 2026 · 3 revisions

Development Preview and Release Model

PGX is being published before 1.0 so developers can inspect the architecture, try the included systems and provide feedback before the public APIs are frozen.

What Development Preview means

  • Source and public documentation are available for evaluation.
  • APIs and configuration formats may change between 0.x releases.
  • Every tagged snapshot defines its own plugin and support boundary.
  • Production use is not currently recommended.
  • Release notes and migration notes take precedence over assumptions based on a development branch.

Public snapshot policy

The public monorepo receives reviewed release snapshots. A candidate is checked for explicit file scope, dependency closure, licensing, internal-development residue, secrets, documentation integrity and a clean exported-tree build.

Published tags are intended to be immutable. A correction moves forward in a new release rather than rewriting an existing tag.

Contributions

Issues and pull requests are welcome when they are focused and reproducible. Accepted work is reviewed against the same public boundary and appears in a subsequent release. Do not attach private project source, licensed assets, credentials or unrelated logs.

Toward 1.0

The path to 1.0 includes a maintained compatibility matrix, reproducible sample, documented public API and deprecation policy, migration notes and stable release/contribution procedures. 1.0 will stabilize the selected public contract; it will not imply that every conceivable PGX system is complete.

Clone this wiki locally