Skip to content

docs: automated documentation updates 2026-04-06#1375

Open
jcllobet wants to merge 2 commits intodevfrom
task/docs-automated-updates-2026-04-06
Open

docs: automated documentation updates 2026-04-06#1375
jcllobet wants to merge 2 commits intodevfrom
task/docs-automated-updates-2026-04-06

Conversation

@jcllobet
Copy link
Copy Markdown
Collaborator

@jcllobet jcllobet commented Apr 7, 2026

Docs refresh for 19:00 PDT. This PR updates documentation to match behavior introduced by commits from the last 24 hours.

Commits reviewed:

Why these docs changed:

  • Example: 0589897 feat(den): add org-managed llm provider library (feat(den): add org-managed llm provider library #1343) changed the previous Cloud story from "Custom LLMs (coming soon)" to a real LLM Providers dashboard where admins save shared credentials, choose models, and grant access to people or teams. packages/docs/introduction.mdx, packages/docs/team-provisioning.mdx, and packages/docs/how-to-connect-a-custom-provider.mdx had to be updated because they still described shared model management as unavailable or purely local.
  • Example: 4f19058 feat(den): add org API key auth and management (feat(den): add org API key auth and management #1368) changed the previous workflow from no org-scoped API key management to a dedicated API Keys screen with named keys, owner/admin access, and one-time secret reveal. The Cloud docs were incomplete because they did not mention API-key-based automation at all or warn that the full secret is only shown once.
  • Example: d9e5a33 feat(den): document den-api with OpenAPI (feat(den): add OpenAPI spec and Swagger docs for den-api #1371) changed the previous workflow from code-only API discovery to a generated OpenAPI surface for den-api, so narrative docs needed to point people to the current API reference instead of leaving route discovery implicit.
  • Example: d231dc2 openapi docs added as tab (openapi docs added as tab #1372) changed the docs navigation from guide-only pages to guide pages plus an API Reference tab. The provisioning and provider docs now point readers to that tab because the old pages had no path to the live endpoint reference.

Documentation updates in this PR:

  • Updated packages/docs/introduction.mdx to replace the outdated Cloud overview with the current Team Templates, Members, Shared Workspace, LLM Providers, API Keys, and API Reference surfaces.
  • Updated packages/docs/team-provisioning.mdx to replace the old template-only workflow with a current provisioning sequence that includes shared model access, API keys for automations, and the API reference tab.
  • Updated packages/docs/how-to-connect-a-custom-provider.mdx to distinguish OpenWork Cloud's shared LLM Providers flow from workspace-level opencode.json setup for local or self-managed providers.
  • Removed or rewrote references to unavailable or outdated behavior such as Custom LLMs being "coming soon".

Why this merits a docs update:

  • Without these changes, the docs would still direct users to an older Cloud workflow that predates org-managed model libraries, API key management, and the new API reference surface, even though the current product now expects those flows.

Validation:

  • git diff --check
  • node -e 'const fs=require("fs"); JSON.parse(fs.readFileSync("packages/docs/docs.json","utf8")); console.log("docs.json OK")'

@mintlify
Copy link
Copy Markdown
Contributor

mintlify bot commented Apr 7, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
differentai 🟢 Ready View Preview Apr 7, 2026, 12:03 AM

@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
openwork-app Ready Ready Preview, Comment Apr 7, 2026 2:50am
openwork-den Ready Ready Preview, Comment Apr 7, 2026 2:50am
openwork-den-worker-proxy Ready Ready Preview, Comment Apr 7, 2026 2:50am
openwork-landing Ready Ready Preview, Comment, Open in v0 Apr 7, 2026 2:50am
openwork-share Ready Ready Preview, Comment Apr 7, 2026 2:50am

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 7, 2026

The following comment was made by an LLM, it may be inaccurate:

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