Skip to content

docs(branding): apply Oracle Trademark Legal–approved product naming#257

Merged
fede-kamel merged 1 commit into
mainfrom
docs/trademark-naming-rebrand
May 23, 2026
Merged

docs(branding): apply Oracle Trademark Legal–approved product naming#257
fede-kamel merged 1 commit into
mainfrom
docs/trademark-naming-rebrand

Conversation

@fede-kamel
Copy link
Copy Markdown
Contributor

@fede-kamel fede-kamel commented May 23, 2026

Summary

Applies the approved product naming across the docs site, README, and contributor markdown.

  • Hero of docs/index.md and docs/workbench.md carries the full product name as a wordmark above the tagline H1.
  • Site header shows the full product name under the wordmark on every page.
  • Body prose uses the approved short name on first mention per file and "the SDK" thereafter.
  • OG / Twitter meta tags and the browser tab title use the approved short name.
  • Site chrome retuned: header layout, hero indent, eyebrow wordmark sizing, redundant home tab removed.
  • Technical identifiers (imports, package name locus-sdk, URLs, paths, container tags, CSS classes) are unchanged.

Out of scope (follow-up)

  • Auto-generated docs/notebooks/notebook_*.md — handled in a follow-up that edits the examples/notebook_*.py docstring source and regenerates.
  • CHANGELOG.md left alone.

Test plan

  • pre-commit run --files <staged> — pass
  • mkdocs build --strict — clean
  • CI green

@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label May 23, 2026
Two approved product names introduced across the marketing-facing
surface:

- Full name: Oracle Generative AI Multi-Agent Reasoning Orchestrator SDK
- Short name: Oracle Generative AI – Multi-Agent Locus SDK

Stand-alone "Locus" is not an approved product name in marketing prose.

Site chrome
- Hero of docs/index.md and docs/workbench.md carries the full name
  as a wordmark above the existing tagline H1.
- Site header shows the full name under the "locus" wordmark, split
  across two lines so it fits next to the dark-mode toggle and search
  at all viewports.
- Title is `flex: 0 0 auto`; palette toggle pulls `margin-left: auto`
  so toggle + search + Oracle/GitHub/PyPI cluster sits flush right.
- Hero copy column gets a 1.75rem desktop indent.
- Eyebrow wordmark uses a compound selector so its font-size defeats
  `.md-typeset .locus-hero p`.
- Removed the redundant "locus" nav tab — home is reachable via the
  diamond logo and wordmark.

Body prose
- First mention of the product per file uses the full short name.
- Subsequent mentions use "the SDK" (generic descriptor).
- OG / Twitter meta tags and tab title use the approved short name.

Left untouched (technical identifiers, outside trademark)
- Python imports, package name `locus-sdk`, URLs, file paths, shell
  commands, container image tags, DB user identifiers, CSS class
  names, ASCII diagrams in code blocks, YAML config values.

Out of scope (follow-up)
- docs/notebooks/notebook_*.md (auto-generated from
  examples/notebook_*.py docstrings).
- CHANGELOG.md (historical record).

Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
@fede-kamel fede-kamel force-pushed the docs/trademark-naming-rebrand branch from 9045608 to bb8d698 Compare May 23, 2026 12:47
@fede-kamel fede-kamel merged commit 585887f into main May 23, 2026
10 checks passed
@fede-kamel fede-kamel deleted the docs/trademark-naming-rebrand branch May 23, 2026 12:57
fede-kamel added a commit that referenced this pull request May 23, 2026
…gonomics + httpx 1.0 cap + trademark naming (#265)

Four PRs of fixes since b20. No new public APIs; tightens the SDK
on durability (StateGraph interrupt resume), ergonomics (OCIModel
aliases, AgentConfig.name, Tool.func), deps (httpx<1.0 cap), and
brings the docs site in line with the approved product name.

- #261 — StateGraph.interrupt_before now writes through the
  checkpointer at the pause boundary; resume advances past the gate
  instead of re-pausing. Inline interrupt() save crash with
  state=None fixed in the same pass. OCIModel gains region= and
  profile= ergonomic aliases. AgentConfig.name + Tool.func surface
  the names users naturally reach for.
- #262 — Capped httpx<1.0; pre-release 1.0.dev3 drops the top-level
  Auth re-export and broke OCIRequestSigner + BearerAuth at import.
- #257 — Applied the Oracle Trademark Legal-approved full name
  (wordmark above hero H1, persistent header) and short name (body
  prose / OG meta / tab title) across docs, README, and contributor
  markdown.
- #264 — OCI client read timeout default 60s→300s for reasoning
  models; integration fixture max_tokens 512→8192 so reasoning
  models have budget for both hidden chain-of-thought and visible
  output; eight stale integration tests refreshed against current
  catalogue / workbench layout.

See CHANGELOG.md for the full breakdown.

Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant