docs(stacks): stacks is no longer in preview - #425
Merged
Merged
Conversation
Prakash, 2026-09-09: stacks should no longer be considered a preview feature. The `:::info` banner on the Stacks concept page was the only place in any Defang repo still saying so — the CLI has no preview wording on `defang stack`, and the other "in preview" strings in the docs are about cloud providers or are dated blog posts. Replaced with the one piece of information the banner carried that is still useful: the minimum CLI version. v2.4.0 shipped 2025-11-27; current is v3.15.1. This matters beyond the page itself: Defang Station's new marketing copy sells "dev, staging and production, each on the cloud and region you choose", which is exactly what stacks does, and it should not point at a page that calls the capability a preview.
Prakash-Sundaresan
approved these changes
Sep 9, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
Prakash confirmed on 2026-09-09 that stacks should no longer be considered a preview feature. This removes the last place that says otherwise.
I kept the one fact the banner carried that is still useful — the minimum CLI version. For context, v2.4.0 shipped 2025-11-27 and current is v3.15.1, so the "new feature" framing had outlived itself by about nine months.
Scope — I checked, this really is the only one
Searched
defang,defang-docs,defang-mvpandportalfor anything describing stacks as preview, beta, experimental, new or not-yet-ready:defang-docs/docs/concepts/stacks.md:13-15defangCLI —src/cmd/cli/command/stack.goShort/Longhelp textdefang-docspages mentioning stacksdefang-docsdefang-mvpwebsiteWhy it matters beyond this page
Defang Station's new marketing copy —
DefangLabs/station#49— sells "dev, staging and production, each on the cloud and region you choose, in your own account." That is precisely what stacks does, and the page it sends readers to should not call the capability a preview.Proof
npm run build(with the Go prebuild step) succeeds, and the rendered page is correct:Two notes on pre-existing conditions, verified against
mainrather than assumed:npm run typecheckreportsCannot find module '@theme/CodeBlock'insrc/components/OneClick/index.tsx. Identical onmain(stashed and re-ran) — it needs generated Docusaurus types, not this change./docs/concepts/mcpand/docs/providers/aws. Neither is on a page this PR touches.Risk & rollback
One line of documentation. Revert the single commit.