Skip to content

docs(readme): state what components do and split shipped from planned - #661

Closed
MRmarioruci wants to merge 1 commit into
mainfrom
docs/readme-direct-language
Closed

docs(readme): state what components do and split shipped from planned#661
MRmarioruci wants to merge 1 commit into
mainfrom
docs/readme-direct-language

Conversation

@MRmarioruci

Copy link
Copy Markdown
Contributor

Rewrites README.md in direct language: say what each component does rather than what it is responsible for, and separate what ships from what is planned.

The component list now names the actual behavior. The Control Panel deploys a Station on request, stores the Station and Upgrader wasms that stations upgrade to, and lists the stations a user belongs to. The Station holds the assets, users, permissions and approval policies, and carries out an operation only once that operation's policy is satisfied. The Upgrader is paired one-to-one with a Station, installs new Station wasms, and can restore the Station when an upgrade fails. Previously three of the four bullets said "is responsible for" or "facilitates common operations" without saying which.

The Target Architecture section listed the CDK, SDK and extensions marketplace in the same breath as shipped components, with the distinction left to the diagram's highlighting. It now says which boxes ship today and which are planned. Multi-chain support likewise read as current and is now marked as not built yet.

Two factual corrections. orbit.global is the landing page and the wallet runs at app.orbit.global, but the intro link and the applications section both pointed at orbit.global for the app. And the tests badge linked to ./actions/workflows/tests.yaml, which GitHub resolves inside the repo tree and 404s.

Unrelated to the release workflow stack (#655 through #658), so it is branched off main and can merge independently. No content was removed except one closing line that repeated the point above it, and the diagrams, commands, badges and links are otherwise untouched.

State what each component does instead of what it is responsible for.
The Control Panel deploys stations and stores the wasms they upgrade to,
the Station holds assets and enforces approval policies, the Upgrader
installs Station wasms and restores a Station when an upgrade fails.

Separate what ships from what is planned: the Target Architecture
section listed the CDK, SDK and extensions marketplace alongside shipped
components, and multi-chain support read as current.

Two corrections. orbit.global is the landing page and the wallet runs at
app.orbit.global, but both the intro link and the applications section
pointed at orbit.global for the app. The tests badge linked to
./actions/workflows/tests.yaml, which resolves inside the repo tree and
404s.
@MRmarioruci
MRmarioruci requested a review from a team as a code owner September 4, 2026 11:04
@zeropath-ai

zeropath-ai Bot commented Sep 4, 2026

Copy link
Copy Markdown

No security or compliance issues detected. Reviewed everything up to 89c3a80.

Security Overview
Detected Code Changes
Change Type Relevant files
Bug Fix ► README.md
    Fix wording/typos and link targets in README
Enhancement (No new functionality or enhancements detected)

@MRmarioruci

Copy link
Copy Markdown
Contributor Author

Wrong file, this was meant for RELEASE.md. Closing.

@MRmarioruci MRmarioruci closed this Sep 4, 2026
@MRmarioruci
MRmarioruci deleted the docs/readme-direct-language branch September 4, 2026 11:06
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.

1 participant