Skip to content

docs(station): correct the open-source claim and adopt the approved positioning - #427

Merged
raphaeltm merged 1 commit into
mainfrom
docs/station-self-host-accuracy
Sep 10, 2026
Merged

raphaeltm merged 1 commit into
mainfrom
docs/station-self-host-accuracy

Conversation

@defang-sam

@defang-sam defang-sam Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

What & why

docs.defang.io/docs/station is live right now saying:

Station runs on Defang's cloud. It is open source, so you can also run it on your own infrastructure.

That is not accurate. DefangLabs/station is a private repository with no LICENSE file. The open-source, self-hostable artefact is Agent Box (defangdevs/agent-box, MIT, public), which Station is built on.

The fix keeps the self-host path findable rather than deleting it — Agent Box now gets its own "Running it yourself" section naming the licence and what you can run it on.

Also brought in line with the merged positioning

The page predated DefangLabs/station ADR-0009 and defang-global constitution 1.2.0, both merged 2026-09-09:

  • Leads with the tagline — Bring your agent. Run it anywhere.
  • Says what Station actually is — Claude Code or OpenAI Codex on an always-on machine, connected to the customer's own Anthropic or OpenAI account — rather than a generic "persistent cloud workspace for AI coding agents".
  • Drops "keeps running when you close your laptop." Retired copy per strategy/language-style-guide.md: it sells absence, and early Station customers value the opposite — being able to reach and direct the agent. It is also the single most commoditised line in the category.
  • Names the Deploy handoff concretely — dev, staging or production on the provider you choose, which is what stacks does.

The in-development :::info note stays; Station has not shipped.

Proof

npm run build (with the Go prebuild) succeeds, and the rendered page is correct:

$ grep -o "Bring your agent. Run it anywhere.\|Agent Box\|MIT" build/docs/station.html | sort | uniq -c
      1 Agent Box
      1 Bring your agent. Run it anywhere.
      1 MIT
$ grep -c "is open source, so you can also run it" build/docs/station.html   → 0

Two pre-existing conditions, verified identical on main rather than assumed: a @theme/CodeBlock typecheck error needing generated Docusaurus types, and two broken anchors on /docs/concepts/mcp and /docs/providers/aws. Neither is on a page this PR touches.

Risk & rollback

One documentation page. Revert the single commit.

If DefangLabs/station is later given a licence, the "Running it yourself" section should be revisited — the claim can then be made directly about Station rather than only about the runtime underneath.

…ositioning

The page said "Station runs on Defang's cloud. It is open source, so you can also
run it on your own infrastructure." That is not accurate: DefangLabs/station is a
private repository with no LICENSE. The open-source, self-hostable artefact is
Agent Box (defangdevs/agent-box, MIT), which Station is built on. The page now
says so, under its own heading, so the self-host path is still findable.

Also brings the page in line with the positioning merged in station ADR-0009 and
defang-global's constitution 1.2.0:

- Leads with the tagline "Bring your agent. Run it anywhere."
- Describes what Station actually is — Claude Code or Codex on an always-on
  machine, connected to the customer's own Anthropic or OpenAI account — rather
  than a generic "persistent cloud workspace".
- Drops "keeps running when you close your laptop", retired copy per
  strategy/language-style-guide.md: it sells absence, while customers value being
  able to reach and direct the agent.
- Names the Deploy handoff concretely: dev, staging or production on the provider
  you choose.
@defang-sam
defang-sam Bot requested a review from a team as a code owner September 9, 2026 23:39
@coderabbitai

coderabbitai Bot commented Sep 9, 2026

Copy link
Copy Markdown

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: f0500813-973a-4457-9730-7cce4bfb11a8

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

@raphaeltm
raphaeltm merged commit d8e5591 into main Sep 10, 2026
6 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