docs: rewrite tools/idempotency/hooks/streaming/mcp + new homepage hero + Capabilities + dark-mode diagrams#29
Merged
Conversation
oracle-contributor-agreement
Bot
added
the
OCA Verified
fede-kamel
force-pushed
the
docs/concept-rewrites-and-brand-polish
branch
from
5cefbfd to
11d7aab
Compare
This was referenced May 2, 2026
fede-kamel
force-pushed
the
docs/concept-rewrites-and-brand-polish
branch
from
11d7aab to
14962e9
Compare
fede-kamel
changed the title
…ro + Capabilities + dark-mode diagrams Concept-page rewrites — same template as the provider pages: pitch / when to pick / getting started / capabilities (each runnable) / gotchas / source. Pages sized 74→156, 56→138, 82→148, 68→140, 51→139. Homepage rewrite: - H1 → "Build agents that reason and solve together." (verb-led, two beats, captures both reasoning + multi-agent pillars). - Subhead → "The Oracle Gen AI Multi-Agent Reasoning SDK." (matches the logo wordmark, Oracle-anchored category claim). - Body → reasoning lives inside the loop (Reflexion / Grounding / Causal) + six-shape verb chain (Compose / Orchestrate / Swarm / Handoff / StateGraph / Functional / A2A) + Oracle proof closer. - "Six things you can ship" section — developer-narrative ordering (Reason → Act → Coordinate → Mesh → Decide → Deploy), benefit-led H3 titles, 14–20-line code blocks with real imports + commented output, descriptive concept + tutorial links (no opaque "Tutorial 03" labels). - H1 margin tightened (1.4rem → 0.6rem) so subhead sits closer. - Drop title='travel_concierge.py' from the hero code block. Capabilities page (renamed from "Feature matrix"): - Honest naming — it's a capability list, not a comparison matrix. - New top-of-page Oracle-distinctive admonition (Oracle-red border + sand-tinted gradient + red star icon, defined in CSS) calls out the six wedge features at a glance. - Every section uses the same 3-column table (Feature / What it does / Surface + concept link). Drops the prose dumps. - mkdocs.yml nav label updated. Dark-mode diagrams: - Architecture SVGs (agent-loop, multi-agent-patterns, the per-pattern SVGs under img/patterns/, architecture, sequence-26ai) were authored against a light background; dark-mode rendering hid the dark-grey strokes. Added a near-white card in slate scheme. Model id fix mirrored: openai.gpt-5.5 → openai.gpt-5 in homepage code blocks, README, and openai provider doc. (Same fix shipping in PR #38 across the rest of the codebase.) Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
fede-kamel
force-pushed
the
docs/concept-rewrites-and-brand-polish
branch
from
14962e9 to
9db72dc
Compare
fede-kamel
changed the title
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
1 participant
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.
Summary
Three layers of work landing together — the next batch of concept-page rewrites, a complete homepage hero/body iteration, and the "Feature matrix" → "Capabilities" rename with a new Oracle-distinctive admonition style.
Concept pages (template-aligned, 74→156, 56→138, 82→148, 68→140, 51→139)
Homepage rewrite
Capabilities (renamed from "Feature matrix")
Dark-mode diagrams
Model id fix mirrored
`openai.gpt-5.5` → `openai.gpt-5` in homepage code blocks, README, and `docs/concepts/providers/openai.md`. Same fix shipping in PR #38 across the rest of the codebase.
Test plan