Skip to content

docs: clarify the skybox note and retire the legacy Splat Publishing page - #1384

Merged
willeastcott merged 1 commit into
mainfrom
docs-supersplat-tidy
Nov 20, 2026
Merged

willeastcott merged 1 commit into
mainfrom
docs-supersplat-tidy

Conversation

@willeastcott

Copy link
Copy Markdown
Contributor

Two small follow-ups from the SuperSplat audit.

Skybox note

Experience Settings › How the viewer reads it said: "the viewer doesn't load the skybox from the settings."

That's true of the open-source viewer, but it read as if Studio skyboxes don't reach visitors. They do. superspl.at's scene page starts the viewer with the scene's skyboxUrl from the page's own data (#sse-bootstrap), the same way it applies the anti-aliasing setting (#1380). The bullet now says the open-source viewer doesn't load it, but superspl.at scene pages and embeds still show the skybox you upload in Studio, and when self-hosting you pass it with skybox or skyboxUrl. Japanese is updated to match.

Legacy Splat Publishing page

/user-manual/api/splat-publish/ was an unlisted page describing the older playcanvas.com/api/splats/publish upload flow (a signed S3 URL, then a processing job). Nothing linked to it after #1368 pointed its last links at API & Integrations.

  • Removed: the page, in English and Japanese, with git rm.
  • Redirect: its URL now goes to /user-manual/supersplat/developers/api-integrations/, so old bookmarks land on the current API docs.

Test change

utils/plugins/llms/test/corpus.test.mjs had a test, "leaves out unlisted docs", that checked llms-full.txt didn't contain this page by name. It was the corpus's only unlisted doc, so the test would have passed without checking anything. It's now "leaves out unlisted and draft docs": it finds every doc with unlisted: true or draft: true and checks that each one is left out. Right now no docs are unlisted or drafts, so it has nothing to check until one exists.

Checks

  • npm run lint: 0 issues
  • npm test: 52/52 pass, including the rewritten test
  • npm run build (en and ja): succeeds with no broken-link or broken-anchor warnings.
  • Redirect: in the built output, /user-manual/api/splat-publish/ and /ja/user-manual/api/splat-publish/ redirect to API & Integrations.

Made in a separate git worktree, so it doesn't touch the in-progress <kbd> work in the main checkout.

🤖 Generated with Claude Code

…page

Experience Settings said the viewer doesn't load the skybox from the
settings. That's true of the open-source viewer, but superspl.at's scene
pages and embeds still show the Studio skybox, because superspl.at
passes it to the viewer itself. Say so, in English and Japanese.

Remove the unlisted /user-manual/api/splat-publish/ page, which
described an older upload flow and had no inbound links. Its URL now
redirects to SuperSplat's API & Integrations.

That page was the corpus test's only example of an unlisted doc, so
the test now checks that every unlisted or draft doc is left out of
llms-full.txt, rather than naming one page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@willeastcott
willeastcott merged commit a7ddbd9 into main Nov 20, 2026
4 checks passed
@willeastcott
willeastcott deleted the docs-supersplat-tidy branch November 20, 2026 01:20

This branch was successfully deployed

1 active deployment
Preview — a463cd76 Deployed Nov 20, 2026 by vercel[bot]
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