Skip to content

Document SDK reference generation (typedoc, docfx, javadoc, sphinx, phpdoc)#6717

Merged
skeptrunedev merged 3 commits into
mainfrom
nick/sdk-reference-docs
Jul 24, 2026
Merged

Document SDK reference generation (typedoc, docfx, javadoc, sphinx, phpdoc)#6717
skeptrunedev merged 3 commits into
mainfrom
nick/sdk-reference-docs

Conversation

@skeptrunedev

@skeptrunedev skeptrunedev commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

New page api-playground/sdk-reference-setup documenting the sdk navigation property shipped in mintlify/mint#9449 + mintlify/server#6963:

  • Supported formats and their artifacts
  • Per-tool artifact generation commands
  • docs.json configuration with property reference
  • Remote HTTPS sources (incl. Maven Central javadoc jars) and size limits
  • .mintignore convention and CI update pattern

Nav entry added after graphql-setup. Follows the graphql-setup page structure.

Note: the sdk property on non-tab divisions is in flight in mintlify/mint#9459 — this page documents tab usage, which works today.


Note

Low Risk
Documentation and navigation wiring only; no product code or runtime behavior changes.

Overview
Documents the sdk navigation property for auto-generating SDK reference pages from TypeDoc, DocFX, Javadoc, Sphinx, and phpDocumentor artifacts.

Adds api-playground/sdk-reference-setup, covering supported formats, artifact generation commands, tab-level docs.json config (format, source, directory), remote HTTPS sources (including Maven Central Javadoc jars) with size limits, .mintignore, and CI refresh patterns. The page is linked in Document APIs nav (after GraphQL setup).

organize/navigation.mdx gains an SDK references section (parallel to OpenAPI) with a tab sdk example and a link to the new guide. Vale accepts doclet(s)? for Javadoc terminology.

Reviewed by Cursor Bugbot for commit 0d2780c. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jul 24, 2026, 12:50 AM

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jul 24, 2026, 12:50 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@skeptrunedev
skeptrunedev merged commit 6d5d62f into main Jul 24, 2026
6 checks passed
@skeptrunedev
skeptrunedev deleted the nick/sdk-reference-docs branch July 24, 2026 00:55
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