Repository navigation
docs: PR1 — Foundation & framing (About Akka, SEO, standards) - #1702
Merged
Merged
Conversation
About Akka section (rename Why Akka -> About Akka, What is Akka landing, seven capability pages with diagrams, Akka Internals), SDK/Libraries SEO disambiguation (head-meta JSON-LD + header switcher), spec-driven page voice pass + workflow SVG, writing standards and Vale rules. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…switcher Rewrite the Akka Internals opening to the canonical enterprise definition and the four-layer platform framing (Components/Runtime/Cloud Stack/ Harnesses) with the platform-intro graphic, matching What is Akka. Simplify the SDK/Libraries switcher: SDK 'for building agentic AI systems', Libraries 'an actor framework'. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace bursty, cutover, masterless, replayable, repoint, rollout, runbook, swappable, browsable, toolchain, and buildable with common- dictionary equivalents so the Vale.Spelling CI gate passes. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The Akka.MarketingWords rule introduced in this PR runs repo-wide, so it flags two pre-existing 'seamlessly' uses (specify/deploy, sdk/metric). Reword them so the repo is clean under the new error-level rule. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- ACP folded into A2A (drop standalone bullet; A2A note). - Soften agent-exposure wording (you add endpoints; not automatic). - Link capability claims to detail: compaction -> agents/memory#_compaction. - Note Views as a query path for the latest value in Akka Memory. - Disambiguate SDK Akka Streaming from the Akka Streams library, with links to each. - Link the Akka Specify Plugin mention to its install step. - Add structural AI-tell guidance to writing-standards.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Reduce machine-generated cadence across the seven capability pages: convert em-dash appositives to colons or short sentences, break stacked triads, vary sentence length, and trim adjective pile-ups. Voice only — canonical definition, the developer-experience/runtime/governance tagline, the four-layer framing, and all claims are unchanged. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
TylerJewell
marked this pull request as ready for review
July 9, 2026 19:37
Replace the small low-contrast disambiguation sentence with a single legible inline switch in the topbar: "You're reading the SDK docs · Switch to Libraries". Larger (.82rem) and higher-contrast text, with an underlined switch link that brightens on hover. Still injected into #topbar-nav and hidden below 1024px, as before. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
ennru
approved these changes
Jul 10, 2026
ennru
left a comment
Contributor
There was a problem hiding this comment.
I updated the new images to have black background so they work even for the light theme.
LGTM.
| @@ -1 +1 @@ | |||
| * xref:index.adoc[Akka Libraries] | |||
| * https://doc.akka.io/libraries/akka-core/current/typed/guide/index.html[Akka Libraries, window="new"] | |||
Contributor
There was a problem hiding this comment.
I'll work on building a more proper libraries landing page in Akka Dependencies basically copying what we right now have in https://doc.akka.io/libraries/index.html
Somewhere here https://doc.akka.io/libraries/akka-dependencies/current/
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR1 — Foundation & framing
head-meta, header switcher notice; Libraries nav/link retargeted to the libraries guide.No dependencies. PR2 and PR3 build on these pages.
🤖 Generated with Claude Code