Resources

Changelog

Track meaningful changes to the StrataGateway platform, infrastructure, APIs, and developer tooling as they become available.

Coming Soon

Development Preview

StrataGateway is still under active development. A public changelog will begin documenting relevant platform changes as services progress toward public availability. No production release history should be inferred from this page today.

Jump to article

Overview

The Changelog provides a structured, chronological record of all notable changes to the StrataGateway platform. It serves as the authoritative source for users to understand what has changed between releases, including new features, improvements, bug fixes, deprecations, and breaking changes.

Chronological, reverse-ordered entries (newest first).
Consistent categorization using standard change types.
Clear identification of breaking changes and deprecations.
Links to relevant documentation, migration guides, and issue trackers.
Machine-parseable structure for tooling integration.

The StrataGateway changelog is currently being designed alongside the platform. No production changelog exists yet. All examples and structures below are illustrative of the planned format.

Current State

The public StrataGateway changelog does not yet exist. This page describes the planned structure and conventions that will govern the changelog once the platform reaches public availability.

Development Preview

The changelog format, categories, and conventions described here are still under design and may evolve before the first public release.

What Belongs in the Changelog

The changelog captures changes that affect external consumers of the StrataGateway platform:

New API endpoints, resources, or fields.
Changes to existing API behavior, request/response schemas, or error codes.
New CLI commands, flags, or output formats.
New SDK methods, types, or configuration options.
New Terraform resources, providers, or arguments.
New infrastructure capabilities (regions, instance types, storage classes).
Changes to authentication, authorization, or security models.
Bug fixes that correct externally observable behavior.
Performance improvements with measurable user impact.
Deprecations, removals, and breaking changes.
Security fixes and vulnerability mitigations.

Internal refactorings, code reorganizations, test additions, and other changes with no externally observable effect are not included in the public changelog.

Change Categories

Every changelog entry uses one of the following standard categories:

CategoryDescriptionBadge
AddedNew features, capabilities, or resources available to users.
ChangedModifications to existing behavior that may affect users.
DeprecatedFeatures marked for removal in a future release.
RemovedFeatures, endpoints, or resources that have been removed.
FixedBug fixes that correct incorrect behavior.
SecurityVulnerability fixes and security hardening.
InfrastructureChanges to underlying platform infrastructure.
Developer ExperienceImprovements to tooling, documentation, or workflows.

Entry Structure

Each changelog entry follows a consistent structure:

FieldDescriptionRequired
CategoryOne of the standard change categories above.Required
SummaryConcise, user-facing description of the change.Required
DetailsAdditional context, migration guidance, or rationale.Optional
ReferencesLinks to related PRs, issues, or documentation.Optional

Release Identifiers

Releases are identified using a versioning scheme that allows users to understand the scope of changes:

SchemeFormatStatus
Semantic VersioningMAJOR.MINOR.PATCH (e.g., 1.4.0)Standard
Date-based SuffixYYYY.MM.DD (e.g., 2026.07.29)Alternative
Build MetadataOptional build metadata per SemVerOptional

The final versioning scheme will be confirmed before the first public release.

Dates and Timestamps

All changelog entries include an ISO 8601 date. Release entries include a release date; individual change entries may include the date the change was merged or released.

Date format

Date formattext
2026-07-29

Dates use the ISO 8601 format (YYYY-MM-DD) for unambiguous parsing and sorting.

Breaking Changes

Breaking changes are called out explicitly in a dedicated section within each release. They include migration guidance and, where applicable, a deprecation timeline.

Illustrative Example

Breaking Changes section

Breaking Changes sectionmarkdown
### Breaking Changes

**API Authentication**
- `Authorization` header format changed from `Token <token>` to `Bearer <token>`.
- Legacy token format will be rejected after 2026-12-31.

**Instance Lifecycle**
- `DELETE /v1/instances/{id}` no longer supports `force=true` parameter.
- Use `POST /v1/instances/{id}/actions/terminate` instead.

Breaking changes must include a migration path and, where applicable, a deprecation timeline with a concrete removal date.

Deprecations

Deprecated features are clearly marked with a removal timeline and a recommended migration path.

Illustrative Example

Deprecations section

Deprecations sectionmarkdown
### Deprecations

**Legacy CLI Command**
- `strata instance list` is deprecated.
- Use `strata compute list` instead.
- Removal planned for 2027-01-01.

Security-Related Changes

Security-related changes are documented with appropriate detail while following responsible disclosure practices.

Illustrative Example

Security section

Security sectionmarkdown
### Security

**TLS Configuration**
- Minimum TLS version raised to 1.2 for all API endpoints.
- TLS 1.0 and 1.1 connections will be rejected.

**Certificate Rotation**
- Platform TLS certificates rotated on 2026-07-15.
- No action required for SDK users.

Security fixes follow responsible disclosure. Details of vulnerabilities are published only after a fix is available and users have had time to upgrade.

API Changes

Changes to the REST API surface are documented with sufficient detail for consumers to update their integrations.

New endpoints or resources.
New fields on existing request/response bodies.
Changes to field types, validation rules, or enum values.
Changes to authentication or authorization requirements.
Changes to rate limits, quotas, or pagination behavior.
Deprecated or removed endpoints.

Infrastructure Changes

Changes to the underlying platform infrastructure that may affect customer workloads:

New regions or availability zones.
Changes to instance types, plans, or pricing.
Storage system upgrades or migrations.
Network architecture changes.
Control plane upgrades or migrations.

Developer Tooling Changes

Updates to the developer experience ecosystem:

CLI: new commands, flags, output formats, or configuration options.
TypeScript SDK: new methods, types, or breaking API changes.
Python SDK: new methods, types, or breaking API changes.
Terraform Provider: new resources, data sources, or attribute changes.
Documentation: significant restructuring or new guides.

Release History

Planned releases with illustrative dates and themes:

VersionDateTheme
0.1.02026-01-15Initial preview release with core compute and networking.
0.2.02026-03-20Added block storage, object storage, and SSH key management.
0.3.02026-05-10Added firewall policies, monitoring metrics, and backup workflows.
0.4.02026-07-29Added Terraform provider, Python SDK, and service status system.

Dates and themes are illustrative. Actual release cadence and content will be determined as the platform matures.

Notifications

Planned channels for changelog update delivery:

ChannelPurposeStatus
RSS / AtomStandard feed for changelog updates.Planned
EmailEmail digest for subscribers.Under Evaluation
WebhookHTTP callbacks for integration with customer systems.Under Evaluation
Dashboard BannerIn-application notification for breaking changes.Planned

Inspect existing project plans before presenting any channel as committed.

Roadmap Relationship

The changelog documents what has been released. The Roadmap documents what is planned. They are complementary but distinct:

Changelog

Past-tense record of shipped changes. Immutable once published.

Roadmap

Forward-looking plan. Subject to change based on priorities and feedback.

Was this page helpful?