release: Merge latest prod-staging changes to prod-stable - #309
Merged
Merged
Conversation
Signed-off-by: aabedraba <abdallah@unikraft.com>
The SDKs sat as three leaf pages under Integrations, alongside Kubernetes and Karpenter, which buried them and gave no room to group client libraries separately from the plugin SDK. Move the pages from /integrations/sdks/* to /sdks/* and give them a top-level "SDKs" tab with two groups: client libraries, and extending the platform. Old URLs redirect to the new ones and the in-page cross-links are rewritten. Signed-off-by: Alexander Jung <alex@unikraft.com>
The new tab opened straight onto the JavaScript SDK, so nothing introduced the set or said which SDK answers which need. Add /sdks/overview as the tab's landing page: what each SDK is for, the idiomatic and plumbing split the client libraries share, how UKC_TOKEN and UKC_METRO are read, and the CLI and REST API as the alternatives. /sdks redirects to it. Signed-off-by: Alexander Jung <alex@unikraft.com>
unikraft-cloud is published on PyPI but the docs only covered the JavaScript and Go clients, so Python users had nothing to go on. Add /sdks/python from the SDK README: installation, the async-only quickstart, client configuration, metro fan-out, references and each(), chainable handles, updates, resources, the error hierarchy and the plumbing layer. List it in the SDKs tab and link it from the overview, JavaScript and plugin pages. Signed-off-by: Alexander Jung <alex@unikraft.com>
The JavaScript SDK gained a Sandbox class that wraps the sandbox plugin, but the page only covered the platform resources, so the shortest path to a running sandbox was undocumented. Add a Sandboxes section following examples/sandbox.ts: create with `await using`, configuration, exec and the start/stdin/wait/logs cycle, the filesystem calls, reconnecting by UUID, and reaching sandboxes through an existing client. Add ukc.sandboxes to the methods table. Signed-off-by: Alexander Jung <alex@unikraft.com>
The platform pages showed each resource through the CLI and the REST API only, so a reader working in a program had no sign that a typed client already covers the same ground. Add a callout to instances, volumes, services, certificates and metros: one snippet in the language that reads best for it, and links to the three SDKs. The metros callout covers fan-out, which has no CLI equivalent. Signed-off-by: Alexander Jung <alex@unikraft.com>
The page described what a sandbox is and linked to the guide, but not to the SDK class that creates one, which is the shortest path from reading to running. Add a callout with the `Sandbox.create` and `exec` snippet, linking to the SDK section and the plugin it wraps. Signed-off-by: Alexander Jung <alex@unikraft.com>
danielvallance
temporarily deployed
to
prod-staging
September 24, 2026 11:50 — with 
GitHub Actions
Inactive
GitHub Actions
Inactive
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Resolve the sandbox availability, Go metro behavior, and Python token documentation issues.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 1
Open (1)
What changed in this PR
Reorganizes SDK documentation, adds Python and Go guides, expands sandbox examples, and updates navigation, links, and feature availability notices.
Changes:
- Adds SDK navigation, redirects, and language-specific documentation.
- Adds SDK usage examples across platform and use-case pages.
- Updates feature and release documentation.
| File | Reviewed changes |
|---|---|
zudoku.config.tsx |
Adds SDK navigation and redirects. |
pages/use-cases/sandboxes.mdx |
Adds SDK sandbox example; availability caveat is needed. |
pages/sdks/python.mdx |
Adds Python SDK reference; token description is incorrectly redacted. |
pages/sdks/plugin.mdx |
Updates SDK links. |
pages/sdks/overview.mdx |
Adds SDK landing page. |
pages/sdks/js.mdx |
Documents sandbox APIs; availability caveat is needed. |
pages/sdks/go.mdx |
Adds Go SDK documentation. |
pages/releases/r13-adrastea.mdx |
Updates SDK references. |
pages/platform/metros.mdx |
Adds multi-metro SDK guidance; Go SDK behavior needs qualification. |
pages/platform/volumes.mdx |
Adds SDK usage guidance. |
pages/platform/services.mdx |
Adds SDK usage guidance. |
pages/platform/instances.mdx |
Adds SDK usage guidance. |
pages/platform/certificates.mdx |
Adds SDK usage guidance. |
pages/features/roms.mdx |
Updates access notices. |
pages/features/plugins.mdx |
Updates availability text and SDK links. |
pages/features/cron-jobs.mdx |
Updates access notices. |
pages/features/checkpoints.mdx |
Updates licensing text. |
pages/features/branching.mdx |
Updates licensing text. |
pages/features/annotations.mdx |
Updates access notices. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
+44
to
+45
| :::tip[Create a sandbox from your own code] | ||
| The [JavaScript SDK](/sdks/js#sandboxes) wraps the [sandbox plugin](/features/plugins#sandbox-plugin) in a `Sandbox` class, so a microVM is a few lines: |
nderjung
approved these changes
Sep 24, 2026
nderjung
left a comment
nderjung
left a comment
Member
There was a problem hiding this comment.
Approved-by: Alexander Jung alex@unikraft.com
This branch was previously deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Automated changes by create-pull-request GitHub action