Batch 2: Fix documentation pages content density

- Reduced heading sizes (text-3xl→text-2xl)
- Simplified descriptions 50-60%
- Normalized verbose technical text
- Fixed: DocsGettingStarted, DocsPlatform, DocsApiReference, DocsCli, DocsExamples, DocsIntegrations, DocsCurriculum

TypeScript validation: No new errors introduced
This commit is contained in:
MrPiglr 2026-01-11 03:52:55 +00:00 committed by GitHub
parent e6b1617b43
commit 28d9410a9f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 30 additions and 44 deletions

View file

@ -110,13 +110,11 @@ export default function DocsApiReference() {
<ServerCog className="mr-2 h-3 w-3" /> <ServerCog className="mr-2 h-3 w-3" />
API Reference API Reference
</Badge> </Badge>
<h2 className="text-3xl font-semibold text-white"> <h2 className="text-2xl font-semibold text-white">
Integrate programmatically with the AeThex API REST API reference and integration guide
</h2> </h2>
<p className="text-gray-300 max-w-3xl"> <p className="text-gray-300 max-w-3xl">
The REST API exposes every core capability of the AeThex platform. Authenticate with OAuth or access tokens, call idempotent endpoints, and subscribe to webhooks for real-time updates.
Authenticate with OAuth 2.1 or personal access tokens, call idempotent
endpoints, and subscribe to webhooks to react to changes in real time.
</p> </p>
</section> </section>

View file

@ -88,14 +88,11 @@ export default function DocsCli() {
<Terminal className="mr-2 h-3 w-3" /> <Terminal className="mr-2 h-3 w-3" />
CLI Tools CLI Tools
</Badge> </Badge>
<h2 className="text-3xl font-semibold text-white"> <h2 className="text-2xl font-semibold text-white">
Operate AeThex from the command line Command-line tools for development and deployment
</h2> </h2>
<p className="text-gray-300 max-w-3xl"> <p className="text-gray-300 max-w-3xl">
The AeThex CLI automates local development, environment management, Automate local development, environment management, and production deployments with cross-platform support.
and production deployments. It is built with stability in mind,
featuring transactional deploys, shell-friendly output, and native
support for Linux, macOS, and Windows.
</p> </p>
</section> </section>

View file

@ -70,7 +70,7 @@ const curriculumModules: CurriculumModule[] = [
id: "foundations", id: "foundations",
title: "AeThex Foundations", title: "AeThex Foundations",
description: description:
"Establish core mastery of the AeThex platform, from environment setup to shipping your first interactive experience.", "Master platform basics from setup to deployment.",
duration: "2.5 hrs", duration: "2.5 hrs",
level: "foundation", level: "foundation",
focus: [ focus: [
@ -129,7 +129,7 @@ const curriculumModules: CurriculumModule[] = [
id: "builder", id: "builder",
title: "Product Builder Track", title: "Product Builder Track",
description: description:
"Design and scale collaborative communities with AeThex real-time tooling, automations, and membership flows.", "Build collaborative communities with real-time tools and automations.",
duration: "3 hrs", duration: "3 hrs",
level: "builder", level: "builder",
focus: ["Community feed", "Workflow automations", "Admin control center"], focus: ["Community feed", "Workflow automations", "Admin control center"],
@ -184,7 +184,7 @@ const curriculumModules: CurriculumModule[] = [
id: "advanced", id: "advanced",
title: "Advanced Ops & Ecosystems", title: "Advanced Ops & Ecosystems",
description: description:
"Engineer large-scale AeThex deployments that blend AI-guided creation, marketplace integrations, and monetization.", "Scale deployments with AI, marketplace, and monetization features.",
duration: "3.5 hrs", duration: "3.5 hrs",
level: "advanced", level: "advanced",
focus: ["AI pipelines", "Marketplace", "Monetization"], focus: ["AI pipelines", "Marketplace", "Monetization"],

View file

@ -22,7 +22,7 @@ const exampleSnippets = [
{ {
title: "Server-side matchmaking", title: "Server-side matchmaking",
description: description:
"Quickly assemble a matchmaking service that uses AeThex queues, weighting rules, and player telemetry streams.", "Build matchmaking with queues, weighting rules, and telemetry.",
language: "TypeScript", language: "TypeScript",
href: "https://github.com/aethex/examples/tree/main/matchmaking-service", href: "https://github.com/aethex/examples/tree/main/matchmaking-service",
code: `import { createQueue, matchPlayers } from "@aethex/matchmaking"; code: `import { createQueue, matchPlayers } from "@aethex/matchmaking";
@ -54,7 +54,7 @@ export async function enqueuePlayer(player) {
{ {
title: "Realtime activity overlays", title: "Realtime activity overlays",
description: description:
"Broadcast live deployment and incident updates to your in-game HUD or operations dashboard using AeThex events.", "Broadcast deployment updates to in-game HUD or dashboards.",
language: "React", language: "React",
href: "https://github.com/aethex/examples/tree/main/realtime-overlay", href: "https://github.com/aethex/examples/tree/main/realtime-overlay",
code: `import { useEffect, useState } from "react"; code: `import { useEffect, useState } from "react";
@ -142,13 +142,11 @@ export default function DocsExamples() {
<Blocks className="mr-2 h-3 w-3" /> <Blocks className="mr-2 h-3 w-3" />
Examples & Templates Examples & Templates
</Badge> </Badge>
<h2 className="text-3xl font-semibold text-white"> <h2 className="text-2xl font-semibold text-white">
Production-ready patterns you can copy Code examples and starter templates
</h2> </h2>
<p className="text-gray-300 max-w-3xl"> <p className="text-gray-300 max-w-3xl">
Explore curated examples covering backend services, realtime overlays, Production-ready examples for backend services, real-time overlays, automation, and integrations.
automation scripts, and workflow integrations. Each project includes
detailed READMEs, infrastructure diagrams, and deployment runbooks.
</p> </p>
</section> </section>

View file

@ -58,14 +58,14 @@ const prerequisites = [
{ {
title: "AeThex Account", title: "AeThex Account",
description: description:
"You will need an active AeThex account to access the dashboard, API console, and deployment tools.", "Active account required for dashboard and API access.",
actionLabel: "Create account", actionLabel: "Create account",
actionHref: "/onboarding", actionHref: "/onboarding",
}, },
{ {
title: "Node.js 18+ & npm", title: "Node.js 18+ & npm",
description: description:
"The AeThex CLI relies on modern Node runtimes. Verify your local toolchain before continuing.", "Modern Node runtime required for CLI.",
actionLabel: "Verify environment", actionLabel: "Verify environment",
actionHref: "https://nodejs.org/en/download", actionHref: "https://nodejs.org/en/download",
}, },
@ -82,13 +82,13 @@ const setupSteps = [
{ {
title: "Install the CLI", title: "Install the CLI",
description: description:
"The CLI bootstraps local projects, provisions cloud environments, and manages deployments.", "Bootstrap projects and manage deployments.",
command: "npm install -g aethex", command: "npm install -g aethex",
}, },
{ {
title: "Authenticate", title: "Authenticate",
description: description:
"Log in with your AeThex credentials or paste a personal access token from the dashboard.", "Log in with credentials or access token.",
command: "aethex login", command: "aethex login",
}, },
{ {
@ -196,8 +196,8 @@ export default function DocsGettingStarted() {
<Rocket className="mr-2 h-3 w-3" /> <Rocket className="mr-2 h-3 w-3" />
Getting Started Getting Started
</Badge> </Badge>
<h2 className="text-3xl font-semibold text-white"> <h2 className="text-2xl font-semibold text-white">
Launch your first AeThex project in under 30 minutes Launch your first project in 30 minutes
</h2> </h2>
<p className="text-gray-300 max-w-3xl"> <p className="text-gray-300 max-w-3xl">
This guide walks through the minimum setup required to ship a This guide walks through the minimum setup required to ship a

View file

@ -101,15 +101,11 @@ export default function DocsIntegrations() {
<Puzzle className="mr-2 h-3 w-3" /> <Puzzle className="mr-2 h-3 w-3" />
Integrations Integrations
</Badge> </Badge>
<h2 className="text-3xl font-semibold text-white"> <h2 className="text-2xl font-semibold text-white">
Connecting partner services to AeThex Third-party integrations and connectors
</h2> </h2>
<p className="text-gray-300 max-w-3xl"> <p className="text-gray-300 max-w-3xl">
AeThex Integrations wrap third-party analytics, identity, payments, Connect analytics, identity, payments, and live-ops tools with unified security and data exchange.
and live-ops tooling behind a consistent runtime, security model, and
visual system. Use this guide to register new connectors, surface
partner UI in product flows, and automate data exchange without
hand-rolled plumbing.
</p> </p>
</section> </section>
@ -135,7 +131,7 @@ export default function DocsIntegrations() {
</CardHeader> </CardHeader>
<CardContent className="space-y-4"> <CardContent className="space-y-4">
<CardDescription className="text-gray-300"> <CardDescription className="text-gray-300">
Open-source MIT-licensed engine with GDScript and C# support MIT-licensed engine with GDScript and C# support
</CardDescription> </CardDescription>
<div className="flex flex-wrap gap-2"> <div className="flex flex-wrap gap-2">
<Badge variant="secondary" className="bg-blue-500/20 text-blue-200">GDScript</Badge> <Badge variant="secondary" className="bg-blue-500/20 text-blue-200">GDScript</Badge>
@ -160,7 +156,7 @@ export default function DocsIntegrations() {
</CardHeader> </CardHeader>
<CardContent className="space-y-4"> <CardContent className="space-y-4">
<CardDescription className="text-gray-300"> <CardDescription className="text-gray-300">
Powerful 2D engine with GML scripting for rapid game development 2D engine with GML scripting for rapid development
</CardDescription> </CardDescription>
<div className="flex flex-wrap gap-2"> <div className="flex flex-wrap gap-2">
<Badge variant="secondary" className="bg-green-500/20 text-green-200">GML</Badge> <Badge variant="secondary" className="bg-green-500/20 text-green-200">GML</Badge>

View file

@ -28,7 +28,7 @@ const platformPillars = [
{ {
title: "Unified dashboard", title: "Unified dashboard",
description: description:
"Monitor deployments, live metrics, and release health from a single control surface. Jump into incidents, approvals, and audit trails without leaving the workspace.", "Monitor deployments, metrics, and incidents from a unified dashboard.",
icon: LayoutDashboard, icon: LayoutDashboard,
href: "/dashboard", href: "/dashboard",
cta: "Visit dashboard", cta: "Visit dashboard",
@ -36,7 +36,7 @@ const platformPillars = [
{ {
title: "AeThex Passport", title: "AeThex Passport",
description: description:
"Give builders portable identity with verified skills, achievements, and cross-product progress synced to their Passport profile.", "Portable identity with verified skills and achievements.",
icon: IdCard, icon: IdCard,
href: "/passport/me", href: "/passport/me",
cta: "Open passport", cta: "Open passport",
@ -169,14 +169,11 @@ export default function DocsPlatform() {
<Sparkles className="mr-2 h-3 w-3" /> <Sparkles className="mr-2 h-3 w-3" />
Platform Experience Platform Experience
</Badge> </Badge>
<h2 className="text-3xl font-semibold text-white"> <h2 className="text-2xl font-semibold text-white">
Deliver cohesive player and builder journeys on AeThex Platform overview and core features
</h2> </h2>
<p className="text-gray-300 max-w-3xl"> <p className="text-gray-300 max-w-3xl">
Beyond deployment pipelines and CLI tooling, AeThex bundles AeThex combines deployment pipelines, collaboration tools, identity systems, and live-ops features for building complete experiences.
collaboration, identity, and live-ops systems so teams can craft
unforgettable experiences. Use this guide to orient new stakeholders
and plan end-to-end platform rollouts.
</p> </p>
</section> </section>