AeThex-Corporation/aethex-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Batch 2: Fix documentation pages content density

Browse source 
- 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
Show stats Download patch file Download diff file Expand all files Collapse all files

8
client/pages/docs/DocsApiReference.tsx
View file

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

9
client/pages/docs/DocsCli.tsx
View file

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

6
client/pages/docs/DocsCurriculum.tsx
View file

@ -70,7 +70,7 @@ const curriculumModules: CurriculumModule[] = [
id: "foundations",
title: "AeThex Foundations",
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",
level: "foundation",
focus: [
@ -129,7 +129,7 @@ const curriculumModules: CurriculumModule[] = [
id: "builder",
title: "Product Builder Track",
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",
level: "builder",
focus: ["Community feed", "Workflow automations", "Admin control center"],
@ -184,7 +184,7 @@ const curriculumModules: CurriculumModule[] = [
id: "advanced",
title: "Advanced Ops & Ecosystems",
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",
level: "advanced",
focus: ["AI pipelines", "Marketplace", "Monetization"],

12
client/pages/docs/DocsExamples.tsx
View file

@ -22,7 +22,7 @@ const exampleSnippets = [
{
title: "Server-side matchmaking",
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",
href: "https://github.com/aethex/examples/tree/main/matchmaking-service",
code: `import { createQueue, matchPlayers } from "@aethex/matchmaking";
@ -54,7 +54,7 @@ export async function enqueuePlayer(player) {
{
title: "Realtime activity overlays",
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",
href: "https://github.com/aethex/examples/tree/main/realtime-overlay",
code: `import { useEffect, useState } from "react";
@ -142,13 +142,11 @@ export default function DocsExamples() {
<Blocks className="mr-2 h-3 w-3" />
Examples & Templates
</Badge>
<h2 className="text-3xl font-semibold text-white">
Production-ready patterns you can copy
<h2 className="text-2xl font-semibold text-white">
Code examples and starter templates
</h2>
<p className="text-gray-300 max-w-3xl">
Explore curated examples covering backend services, realtime overlays,
automation scripts, and workflow integrations. Each project includes
detailed READMEs, infrastructure diagrams, and deployment runbooks.
Production-ready examples for backend services, real-time overlays, automation, and integrations.
</p>
</section>

12
client/pages/docs/DocsGettingStarted.tsx
View file

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

14
client/pages/docs/DocsIntegrations.tsx
View file

@ -101,15 +101,11 @@ export default function DocsIntegrations() {
<Puzzle className="mr-2 h-3 w-3" />
Integrations
</Badge>
<h2 className="text-3xl font-semibold text-white">
Connecting partner services to AeThex
<h2 className="text-2xl font-semibold text-white">
Third-party integrations and connectors
</h2>
<p className="text-gray-300 max-w-3xl">
AeThex Integrations wrap third-party analytics, identity, payments,
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.
Connect analytics, identity, payments, and live-ops tools with unified security and data exchange.
</p>
</section>
@ -135,7 +131,7 @@ export default function DocsIntegrations() {
</CardHeader>
<CardContent className="space-y-4">
<CardDescription className="text-gray-300">
Open-source MIT-licensed engine with GDScript and C# support
MIT-licensed engine with GDScript and C# support
</CardDescription>
<div className="flex flex-wrap gap-2">
<Badge variant="secondary" className="bg-blue-500/20 text-blue-200">GDScript</Badge>
@ -160,7 +156,7 @@ export default function DocsIntegrations() {
</CardHeader>
<CardContent className="space-y-4">
<CardDescription className="text-gray-300">
Powerful 2D engine with GML scripting for rapid game development
2D engine with GML scripting for rapid development
</CardDescription>
<div className="flex flex-wrap gap-2">
<Badge variant="secondary" className="bg-green-500/20 text-green-200">GML</Badge>

13
client/pages/docs/DocsPlatform.tsx
View file

@ -28,7 +28,7 @@ const platformPillars = [
{
title: "Unified dashboard",
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,
href: "/dashboard",
cta: "Visit dashboard",
@ -36,7 +36,7 @@ const platformPillars = [
{
title: "AeThex Passport",
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,
href: "/passport/me",
cta: "Open passport",
@ -169,14 +169,11 @@ export default function DocsPlatform() {
<Sparkles className="mr-2 h-3 w-3" />
Platform Experience
</Badge>
<h2 className="text-3xl font-semibold text-white">
Deliver cohesive player and builder journeys on AeThex
<h2 className="text-2xl font-semibold text-white">
Platform overview and core features
</h2>
<p className="text-gray-300 max-w-3xl">
Beyond deployment pipelines and CLI tooling, AeThex bundles
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.
AeThex combines deployment pipelines, collaboration tools, identity systems, and live-ops features for building complete experiences.
</p>
</section>