Skip to content

docs(connectors): writing-a-connector guide + registry/discovery#95

Merged
suleimansh merged 1 commit into
mainfrom
docs/connectors
Jun 30, 2026
Merged

docs(connectors): writing-a-connector guide + registry/discovery#95
suleimansh merged 1 commit into
mainfrom
docs/connectors

Conversation

@suleimansh

Copy link
Copy Markdown
Member

Closes #90 — the last child of the connectors epic #86.

Makes the third-party connector path real and discoverable on the docs site.

New pages

  • packages/connectors — the @gemstack/connectors contract + a worked writing a connector guide (defineConnector, tool shape, handler context, auth spec, mounting, testing), using the examples/connectors-quickstart reference connector.
  • packages/connectors-registry — the discovery story: the connector-* naming convention (mirrors the Vike extensions listing model), the first-party listing, and how to publish + get linked.
  • packages/connector-github and packages/connector-google-drive — per-connector reference pages.

Wiring

  • Sidebar (guide + packages) and nav updated; new Connectors sidebar group.
  • packages/index family table + diagram gain a connectors row/section.

Docs build is green with no dead links. No changeset (docs only).

After this merges, epic #86 is complete.

Add the connectors family to the docs site: the @gemstack/connectors
contract page with a worked 'writing a connector' guide (defineConnector,
tool shape, handler context, auth, mounting, testing), a connector registry
page (connector-* convention + first-party listing + how to publish), and
per-connector pages for GitHub and Google Drive. Wire sidebar, nav, and the
family overview.

Closes #90
@suleimansh suleimansh self-assigned this Jun 30, 2026
@suleimansh suleimansh added documentation Improvements or additions to documentation priority: medium Worth doing, not urgent labels Jun 30, 2026
@suleimansh suleimansh merged commit 15126bc into main Jun 30, 2026
1 check passed
@suleimansh suleimansh deleted the docs/connectors branch June 30, 2026 21:10
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 priority: medium Worth doing, not urgent

Projects

None yet

Development

Successfully merging this pull request may close these issues.

connectors: docs — writing a connector + registry/discovery

1 participant