Skip to content

docs(ecosystem): align extension development and contribution guides with v2 - #40

Open
xiaoland wants to merge 2 commits into
mainfrom
feat/ecosystem-contribution-dx
Open

xiaoland wants to merge 2 commits into
mainfrom
feat/ecosystem-contribution-dx

Conversation

@xiaoland

@xiaoland xiaoland commented Oct 22, 2026 •

Copy link
Copy Markdown
Member

Intent

Align the extension developer journey and contributor entry points with current Extension management v2 and observed behavior.

  • Use released Toolkit 0.5.0, wheel finalization, v2 Registry preview, and a local server that handles generated rewrites.
  • Correct shared Host dependency installation and content-based snapshot reuse.
  • Update peer selection/status commands, Registry links, and six Source guides.
  • Explain that released CLI 0.2.1 still calls the old endpoint; document installation from a reviewed checkout until a corrected release exists.
  • Clarify repository ownership, package access, and implementation scope versus release selection.

Primary scope: ecosystem. Release projects: none; website content changes.
Tracking issue: InKCre/.github#39.

Evidence

  • pnpm --dir website check passed.
  • Released Toolkit 0.5.0 built and finalized an independent Source wheel and generated a v2 preview Registry; the documented local route handling worked.
  • Real Core/CLI with isolated disposable PostgreSQL completed selection, restart, enabling, collection, indexing, text retrieval, and graph inspection. A/A/B/A snapshot reuse, id-only changes, invalid-JSON recovery, and retained information after disable/unselect passed.
  • All six cited native releases returned 200 from the public v2 Registry.

Next action

@xiaoland coordinates review of tutorial accuracy and the CLI transition. After the corrected CLI is published, update the temporary checkout installation instructions. Follow-up public self-hosting verification is available in docs#44; the smaller docs#45 independently adds community links to the contribution page.

Risk and rollback

Coordinate command migration with impl-py#153. Full Web UI and remote Web peer forwarding were not verified end to end. Reverting the documentation does not change persisted information.

Delivery effects

Website deployment follows the existing merge workflow. Ready for review; no package publication, Registry mutation, or Spoke submodule-pointer update. The latest main was integrated and the website check passed again locally and in GitHub CI.

Related work

No stacked parent or child PR.
.github#36, impl-py#153, impl-ts#152, ui#64.

- 按实际运行结果修正 Toolkit 预览、依赖安装和快照去重说明
- 迁移 Peer 选择命令、Registry 链接并说明已发布 CLI 的版本缺口
- 补齐外部贡献路径与跨仓交付约束
- Preserve current main changes before reviewing contribution delivery.

This branch was successfully deployed

1 active deployment
preview — 6dab7ecf Deployed Oct 26, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

Status: Review / acceptance

Development

Successfully merging this pull request may close these issues.

1 participant