feat(docs): two-product shell and the approved tagline (WS4) - #422
Merged
Merged
Conversation
Tagline: docusaurus.config.js carried a FOURTH tagline nobody had decided on
("A radically simpler way to build and deploy production-ready cloud apps").
Replaced with the product tagline, which is what a docs site should carry.
Structure: ADD, do not move. Every one of the 84 existing doc URLs is
unchanged, so none of the 49 entries in redirects.json needed touching and no
new redirect was added. The five sections that were top-level navbar items
(Overview, Tutorials, Concepts, Providers, CLI) are now grouped in a "Deploy"
dropdown, and "Station" is a new top-level item.
Added docs/station/station.mdx as a placeholder at /docs/station, plus a
stationSidebar entry. It states plainly that Station is in development and
contrasts the two products.
Verified with a local docusaurus build: exit 0, /docs/intro, /docs/concepts,
/docs/tutorials and /docs/providers all still build, /docs/station builds, and
the rendered navbar shows one Deploy dropdown plus Station.
Note for reviewers: `npm run build` runs scripts/prebuild.sh, which needs Go to
generate docs/cli. Without it the CLI sidebar is empty and EVERY page fails to
render ("Sidebar with ID cliSidebar doesn't have anything to be linked to").
That happens on main too and is not caused by this change.
NOT ANNOUNCED: this puts "Defang Station" and "Deploy" on public docs. Hold
until launch.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
defangdevs
approved these changes
Sep 8, 2026
defangdevs
left a comment
Contributor
There was a problem hiding this comment.
Reviewed the diff (docs/station/station.mdx, docusaurus.config.js, sidebars.js) against DefangLabs/defang-global#135 (merged naming source of truth):
- Tagline:
docs/station.mdxanddocusaurus.config.jsuse "Develop Once, Deploy Anywhere." — matches the Defang Deploy product-level tagline in the guide exactly (right level for a developer-facing surface). - Navbar: all 5 previously top-level items keep their existing routes/sidebar IDs unchanged, just regrouped under a new "Deploy" dropdown — confirms no redirects were needed.
stationSidebar→docs/stationwired correctly in sidebars.js; single-page autogenerated sidebar doesn't need a_category_.json.- CI green (Analyze, CodeQL, Test deployment).
No blocking issues. Agreed this should sit unmerged until the announcement per the PR warning — not merging.
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.
Warning
Ready for review, but NOT ready to merge.
This PR puts the product names on public surfaces, and they are not announced yet. Merging publishes them. Please review and approve, then leave it for the announcement.
Why
Two things: the docs carried a tagline nobody decided on, and they had no room for a second product.
1. There was a fourth tagline
docusaurus.config.js:20read:That is not the company tagline, not the product tagline, and not the retired
Cloud, Simplified. It is a fourth line. Replaced with the product tagline — the docs serve developers, so that is the right level, and it invents nothing.2. Two-product shell — ADD, do not move
Every one of the 84 existing doc URLs is unchanged. No entry in
redirects.jsonwas touched, and no new redirect was needed. Moving instead of adding would have meant ~84 new redirects on top of the 49 already there.The five sections that were top-level navbar items are now grouped in a Deploy dropdown:
Added
docs/station/station.mdxat/docs/stationplus astationSidebar. It says plainly that Station is in development, and contrasts the two products so a reader who lands there is not confused.Verification
Local
docusaurus build: exit 0./docs/intro,/docs/concepts,/docs/tutorials,/docs/providers/docs/station/docs/introDeploydropdown + oneStation, with the five sections insideOne thing reviewers should know
npm run buildrunsscripts/prebuild.sh, which needs Go to generatedocs/cli. Without Go the CLI sidebar is empty and then every page fails to render:That reproduces on clean
main(89 failing paths there, 90 here — the extra one is the new Station page failing for the same reason). It is environmental, not caused by this change. I verified my change by stubbingdocs/clilocally, building green, then removing the stub.docs/cli/.gitignoreand_category_.jsonare untouched in the final diff.Context
DefangLabs/defang-global#135— the naming source of truth, including which tagline each surface takesDefangLabs/defang-mvp#3232— WS3, the website side01M1YE64QV7YFRA2B1B7YG9AWR🤖 Generated with Claude Code