From 926e7a66f4d49ec41337d12df5b40483bedd7283 Mon Sep 17 00:00:00 2001 From: ukimsanov Date: Mon, 3 Aug 2026 14:01:16 -0700 Subject: [PATCH] docs: separate developer guides from reference --- docs/docs.json | 89 +++++++++++++++++++++++++++++-------------- docs/packages/cli.mdx | 1 + 2 files changed, 61 insertions(+), 29 deletions(-) diff --git a/docs/docs.json b/docs/docs.json index 1932744be9..0d3b4002b9 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -430,7 +430,7 @@ "icon": "code", "groups": [ { - "group": "Overview", + "group": "Start here", "pages": ["developers/overview"] }, { @@ -438,7 +438,7 @@ "pages": ["developers/cli", "packages/cli", "packages/lint"] }, { - "group": "SDK", + "group": "SDK guides", "pages": [ "sdk/quickstart", "sdk/guides/querying-and-editing", @@ -447,7 +447,12 @@ "sdk/guides/persistence", "sdk/guides/embedded-override-mode", "sdk/guides/canvas-integration", - "sdk/guides/editing-affordances", + "sdk/guides/editing-affordances" + ] + }, + { + "group": "SDK reference", + "pages": [ "sdk/reference/open-composition", "sdk/reference/composition", "sdk/reference/edit-operations", @@ -457,27 +462,30 @@ ] }, { - "group": "Composition and animation", + "group": "Composition, design & animation", "pages": [ "concepts/compositions", "concepts/variables", - "reference/html-schema", "concepts/data-attributes", - "reference/color-grading", "guides/gsap-animation", "concepts/frame-adapters", "concepts/determinism", "guides/html-in-canvas", - "guides/hyperframes-vs-remotion" + "guides/hyperframes-vs-remotion", + "guides/figma" ] }, { - "group": "Rendering and deployment", + "group": "Composition reference", + "pages": ["reference/html-schema", "reference/color-grading"] + }, + { + "group": "Rendering paths", + "pages": ["guides/rendering", "deploy/overview", "deploy/cloud", "guides/deploy"] + }, + { + "group": "Cloud infrastructure", "pages": [ - "guides/rendering", - "deploy/overview", - "deploy/cloud", - "guides/deploy", "deploy/aws-lambda", "deploy/gcp-cloud-run", "deploy/templates-on-lambda", @@ -505,28 +513,24 @@ ] }, { - "group": "Integrations", + "group": "Agent setup", "pages": [ "guides/authentication", "guides/skills", - "guides/figma", "guides/antigravity", "guides/copilot-cli" ] }, { - "group": "Contributing", + "group": "Contributing & community", "pages": [ "contributing", "contributing/catalog", "contributing/release-channels", "contributing/changelog-process", - "contributing/testing-local-changes" + "contributing/testing-local-changes", + "community/adopters" ] - }, - { - "group": "Community", - "pages": ["community/adopters"] } ] } @@ -542,25 +546,52 @@ { "header": "Explore", "items": [ - { "label": "Introduction", "href": "/introduction" }, - { "label": "Make your first video", "href": "/quickstart" }, - { "label": "Examples", "href": "/examples" } + { + "label": "Introduction", + "href": "/introduction" + }, + { + "label": "Make your first video", + "href": "/quickstart" + }, + { + "label": "Examples", + "href": "/examples" + } ] }, { "header": "Build", "items": [ - { "label": "Studio", "href": "/studio" }, - { "label": "Catalog", "href": "/catalog" }, - { "label": "Developers", "href": "/developers/overview" } + { + "label": "Studio", + "href": "/studio" + }, + { + "label": "Catalog", + "href": "/catalog" + }, + { + "label": "Developers", + "href": "/developers/overview" + } ] }, { "header": "Resources", "items": [ - { "label": "Product updates", "href": "/product-updates" }, - { "label": "Playground", "href": "https://www.hyperframes.dev/" }, - { "label": "GitHub", "href": "https://github.com/heygen-com/hyperframes" } + { + "label": "Product updates", + "href": "/product-updates" + }, + { + "label": "Playground", + "href": "https://www.hyperframes.dev/" + }, + { + "label": "GitHub", + "href": "https://github.com/heygen-com/hyperframes" + } ] } ] diff --git a/docs/packages/cli.mdx b/docs/packages/cli.mdx index 42ff73ec83..f5d0a19031 100644 --- a/docs/packages/cli.mdx +++ b/docs/packages/cli.mdx @@ -1,5 +1,6 @@ --- title: CLI +sidebarTitle: "CLI reference" description: "Create, preview, and render HTML video compositions from the command line." ---