Skip to content

docs: add status sections and switch development clones to HTTPS - #21

Open
darrenapfel wants to merge 2 commits into
deepgram:mainfrom
darrenapfel:dx-reboot/wp23-triage
Open

docs: add status sections and switch development clones to HTTPS#21
darrenapfel wants to merge 2 commits into
deepgram:mainfrom
darrenapfel:dx-reboot/wp23-triage

Conversation

@darrenapfel

Copy link
Copy Markdown

What this changes. Status sections in the root README and the package README (the file npmjs.com renders) state that the package is experimental and pre-1.0 and name the official JavaScript SDK (@deepgram/sdk) as the supported production path for the Voice Agent API. The development clone commands used SSH remotes, which fail for anyone without a GitHub SSH key; they now use HTTPS.

Validation. The advertised install path (npm install @deepgram/react @deepgram/agents) and the quick-start example were verified working in a clean-room Vite 8 build on 2026-08-24, so no code-facing changes were needed. The change touches only markdown.

Provenance. This change was written by an artificial-intelligence coding agent operating on a local clone, at the direction of Darren Apfel, and was validated as described above.

🤖 Generated with Claude Code

Darren Apfel and others added 2 commits August 24, 2026 20:15
- Status sections in the root README and the package README (the file
  npmjs.com renders) state that the package is experimental and pre-1.0 and
  name @deepgram/sdk (the official JavaScript SDK) as the supported
  production path for the Voice Agent API.
- The development clone commands used SSH remotes, which fail for anyone
  without a GitHub SSH key; they now use HTTPS.

The advertised install path ('npm install @deepgram/react @deepgram/agents')
and the quick-start example were verified working in a clean-room Vite 8
build on 2026-08-24; no changes were needed there.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Removes the positioning claims from the Status sections (the
experimental label where it editorializes, and the steering of
production integrations to @deepgram/sdk) while keeping the factual
parts: pre-1.0, interfaces may change, release cadence, and the
sibling-package map. Staged as a variant for the wording-alignment
conversation Corey Weathers asked for; not pushed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@darrenapfel

Copy link
Copy Markdown
Author

Per review: the positioning sentences ("experimental" and the production-path steering toward @deepgram/sdk) are replaced with neutral factual status wording (pre-1.0, interfaces may change) pending the wording-alignment conversation — the full before/after set is documented, and either version can land once the positioning call is made.

🤖 Generated with Claude Code

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