Skip to content

Document the first public release - #95

Merged
IlyaasK merged 2 commits into
mainfrom
hypeship/v1-migration-docs
Jul 29, 2026
Merged

Document the first public release#95
IlyaasK merged 2 commits into
mainfrom
hypeship/v1-migration-docs

Conversation

@IlyaasK

@IlyaasK IlyaasK commented Jul 11, 2026

Copy link
Copy Markdown
Collaborator

Summary

Documents v1 as the Kernel Terraform provider's first public release.

  • Updates the changelog to the selected public surface: project and browser-pool resources plus four lookup data sources.
  • Adds docs/first-release.md with supported surface, durable-state boundaries, and import guidance for existing Kernel objects.
  • Describes import as adoption of an existing API object, not migration from an older provider.
  • Corrects the release checklist: this repository has no published provider tags.
  • Links the first-release guide from the README.

Why this is release work

Users need an accurate initial-release contract before the provider is tagged and published. There is no public upgrade path to document because no earlier provider version has been published.

Provider behavior

No provider behavior, schema, state, import implementation, API, SDK, workflow, or example changes.

Tests run

  • gofmt -l cmd internal
  • go test -short -timeout=2m ./...
  • go vet ./...
  • go mod verify
  • go mod tidy -diff
  • terraform fmt -check -recursive examples
  • bash scripts/check-docs.sh
  • bash scripts/check-markdown-links.sh
  • bash scripts/check-examples.sh
  • git diff --check

Acceptance status

Acceptance behavior is unchanged. One complete six-package run against the final release commit remains a manual pre-tag gate.

Intentionally unsupported

  • No browser-pool data source.
  • No deployment, app, or API-key data sources.
  • No profile, proxy, extension, deployment, app, or API-key resources.
  • No browser/session runtime operations, force destroy, force release, or recovery.

Note

Low Risk
Documentation and release-process text only; no provider, schema, or runtime behavior changes.

Overview
Frames v1 as the first public Kernel Terraform provider release and states there is no upgrade or migration from earlier published tags.

CHANGELOG now lists the supported surface (project and browser-pool resources, four lookup data sources, import forms) and what is intentionally excluded, with a pointer to the new guide.

Adds docs/first-release.md covering public API surface, durable-state boundaries, import-as-adoption (not provider migration), and pre-tag acceptance evidence.

docs/release.md preconditions are updated to match (no v0 public narrative; release notes should include the first-release guide). README links to the guide for adoption of existing projects and pools.

Reviewed by Cursor Bugbot for commit 887f36b. Bugbot is set up for automated code reviews on this repo. Configure here.

@IlyaasK
IlyaasK marked this pull request as ready for review July 11, 2026 19:09
@IlyaasK
IlyaasK requested review from Sayan- and tnsardesai and removed request for Sayan- and tnsardesai July 11, 2026 19:09
@IlyaasK
IlyaasK force-pushed the hypeship/app-data-source-acceptance branch from 42e648d to f6258e5 Compare July 13, 2026 13:35
@IlyaasK
IlyaasK force-pushed the hypeship/v1-migration-docs branch 2 times, most recently from 8931430 to 9aa157d Compare July 13, 2026 14:32
@IlyaasK
IlyaasK force-pushed the hypeship/app-data-source-acceptance branch from 21b0ea2 to 269fe20 Compare July 13, 2026 15:39
@IlyaasK
IlyaasK force-pushed the hypeship/v1-migration-docs branch from 9aa157d to 16fd4ee Compare July 13, 2026 15:39
@IlyaasK
IlyaasK force-pushed the hypeship/v1-migration-docs branch 3 times, most recently from d715c4f to 57d9203 Compare July 21, 2026 18:10
@IlyaasK
IlyaasK force-pushed the hypeship/app-data-source-acceptance branch from 2eb8375 to 959e321 Compare July 21, 2026 19:51
@IlyaasK
IlyaasK force-pushed the hypeship/v1-migration-docs branch from 57d9203 to 6fb4bc3 Compare July 21, 2026 19:51
@IlyaasK
IlyaasK force-pushed the hypeship/app-data-source-acceptance branch from 959e321 to dcbf871 Compare July 21, 2026 20:15
@IlyaasK
IlyaasK force-pushed the hypeship/v1-migration-docs branch from 6fb4bc3 to 63cef2d Compare July 21, 2026 20:15
@IlyaasK
IlyaasK requested review from Sayan- and removed request for Sayan- July 28, 2026 14:16
@IlyaasK
IlyaasK force-pushed the hypeship/v1-migration-docs branch from 63cef2d to 0d2b5f0 Compare July 28, 2026 14:22
@IlyaasK IlyaasK changed the title Document the first public v1 migration Document the first public release Jul 28, 2026
@IlyaasK
IlyaasK changed the base branch from hypeship/app-data-source-acceptance to hypeship/v1-acceptance-matrix July 28, 2026 14:23
@IlyaasK IlyaasK closed this Jul 28, 2026
@IlyaasK
IlyaasK deleted the hypeship/v1-migration-docs branch July 28, 2026 14:24
@IlyaasK
IlyaasK restored the hypeship/v1-migration-docs branch July 28, 2026 14:24
@IlyaasK IlyaasK reopened this Jul 28, 2026
@IlyaasK
IlyaasK requested a review from Sayan- July 28, 2026 14:32
@IlyaasK
IlyaasK force-pushed the hypeship/v1-acceptance-matrix branch from 67f66ed to e24b30a Compare July 29, 2026 19:52
@IlyaasK
IlyaasK changed the base branch from hypeship/v1-acceptance-matrix to main July 29, 2026 19:57
@IlyaasK
IlyaasK force-pushed the hypeship/v1-migration-docs branch from 8417018 to 887f36b Compare July 29, 2026 19:57
@IlyaasK
IlyaasK merged commit 4a77113 into main Jul 29, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants