Skip to content

docs: present the Akka Agentic AI Platform in About Akka - #2078

Merged
ennru merged 3 commits into
mainfrom
docs/about-akka
Oct 15, 2026
Merged

ennru merged 3 commits into
mainfrom
docs/about-akka

Conversation

@TylerJewell

Copy link
Copy Markdown
Contributor

Rewrites the About Akka section around the Akka Agentic AI Platform and its four solutions: Akka SDK, Akka Specify, Akka Verify and Akka Optimize. It is one PR so the section can be read as a whole. It can be split for merge if reviewers prefer.

New pages

  • About Akka: the platform, a diagram of the four solutions, a table that sends each solution to where it is documented, and where to start by task.
  • How the solutions work together: what the solutions share (the specification, the runtime, the ledger, the controls), one agent followed from specification to a trained model, and what applies to agents built elsewhere.
  • Akka SDK, Akka Specify, Akka Verify, Akka Optimize: one page each. Each ends with a table of where the solution is covered in the task sections.
  • How Akka runs: the runtime, the deployment options (Serverless, Dedicated, BYOC, BYOK8s, self-managed), and what Akka Automated Operations adds.
  • Resources moves from Understanding into About Akka.

Only About Akka names the solutions. The other sections keep their task names.

Retired

what-is-akka, akka-agents, akka-orchestration, akka-memory, akka-streaming, akka-automated-operations and akka-internals, with their images. Every old URL is an alias on the page that replaces it, including how-akka-works, why-akka and who-uses-akka.

Content from those pages that no other page had moves first:

  • sdk:streaming: the SDK streaming vs Akka Streams note, and back-pressure.
  • concepts:ai-orchestration-patterns: waiting for a person.
  • concepts:deployment-model: cluster details (no primary node, broker-less encrypted gRPC, clusters across clouds).
  • sdk:views: reads scale separately from writes.

Other changes

  • Home page: the platform statement as the lede, the About card lists the new pages, and Testing and Training cards are added.
  • llms.txt: a new preamble with the platform statement and the four definitions, a new About Akka section, and no "Akka Platform".
  • docs/AGENTS.md and docs/writing-standards.md: About Akka may name the solutions and describe the whole platform, including capabilities that have no task page yet, without status labels and without marketing figures. "Akka Specify" names the solution and "Akka Specify Plugin" names the plugin.

Checks

  • Vale: 0 errors on the changed pages.
  • Local Antora build: no errors on changed files.
  • Redirects and new anchors checked in the rendered site.

Follow-ups

  • The Akka.SpecifyTerminology Vale rule uses a lookahead that Vale's regex engine does not support, so it never fires. It is unchanged here.
  • Operating still frames one page by solution ("Akka Optimize" in the production readiness nav).
  • The Training nav title comes from akka/nexus (optimize-docs) and reads "Akka Optimize".

- About Akka introduces the platform and its four solutions, with a page
  for each, a page on how they work together, and How Akka runs
- the seven capability pages are retired; their URLs alias to the new
  pages, and content found nowhere else moves to SDK and Understanding
- Resources moves from Understanding to About Akka
- the home page and llms.txt use the platform statement; the home grid
  adds Testing and Training
- writing rules allow the About section to name solutions and describe
  the full platform, and allow "Akka Specify" as the solution name
- routing, back-pressure, observability, multi-tenancy and evaluator
  timing now match the inference, operating and governance pages
- Verify takes risk from the specification's risk envelope
- Optimize describes the improvement policy
- keep the Specify terminology rule; About Akka framing overrides the
  overhaul spec's positioning
- llms.txt no longer says Akka Platform
@ennru
ennru merged commit 33d87e1 into main Oct 15, 2026
11 checks passed
@ennru
ennru deleted the docs/about-akka branch October 15, 2026 11:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation documentation related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants