Skip to content

docs: separate released and unreleased install paths - #1448

Merged
Teingi merged 4 commits into
oceanbase:masterfrom
Teingi:codex/fix-install-dsh-docs
Sep 4, 2026
Merged

docs: separate released and unreleased install paths#1448
Teingi merged 4 commits into
oceanbase:masterfrom
Teingi:codex/fix-install-dsh-docs

Conversation

@Teingi

@Teingi Teingi commented Sep 4, 2026

Copy link
Copy Markdown
Member

Which issue or RFC does this PR close?

No linked issue. This fixes a user-reported onboarding failure.

Rationale for this change

The root README installed the released powercontext==0.1.0, then immediately recommended the unreleased powercontext service install command. It also configured integrations from the old v0.1.0 Git tag instead of the matching powercontext-v0.1.0 release tag. A user following those adjacent instructions therefore received No such command 'service' and could install an integration from a different code revision than the CLI and Server.

What changes are included in this PR?

  • Separate released and unreleased installation paths in the English, Chinese, and Japanese root READMEs.
  • Use the matching powercontext-v0.1.0 integration ref for the PyPI 0.1.0 package.
  • Keep the native service commands within the unreleased master path where they are available.
  • Keep powercontext server run as the copy-pasteable startup path for the released package.

Are there any user-facing changes?

Documentation now gives copy-pasteable, version-matched startup paths. There are no API, runtime, or persisted-data changes.

How was this change tested?

  • make docs-test
  • git diff --check upstream/master...HEAD
  • Repository hooks for case conflicts, merge conflicts, end-of-file normalization, and trailing whitespace

The full hook command also ran ty check, which reported three unresolved scripts.scope_binding imports in unchanged upstream Codex plugin files. The exact upstream commit (259bee3a) has successful quality, check-docs, test-matrix, and integration check runs.

AI usage statement

OpenAI Codex (GPT-5) assisted with diagnosis, documentation edits, and validation.

@Teingi Teingi closed this Sep 4, 2026
@Teingi Teingi changed the title docs: fix install and DSH startup guidance docs: separate released and unreleased install paths Sep 4, 2026
@Teingi Teingi reopened this Sep 4, 2026
@Teingi
Teingi marked this pull request as ready for review September 4, 2026 02:46
@Teingi
Teingi requested a review from PsiACE September 4, 2026 02:47

@PsiACE PsiACE left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@Teingi
Teingi merged commit f0f288a into oceanbase:master Sep 4, 2026
17 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.

3 participants