Skip to content

docs: use the approved product names - #428

Merged
fede-kamel merged 2 commits into
mainfrom
docs/approved-product-name
Nov 5, 2026
Merged

fede-kamel merged 2 commits into
mainfrom
docs/approved-product-name

Conversation

@fede-kamel

Copy link
Copy Markdown
Member

PR Legal (2026-11-05) did not approve "Locus" as a stand-alone product name. This change applies the approved naming to everything a reader sees, and keeps the logo and the lowercase wordmark.

Rule applied

  • The full name, Oracle Generative AI Multi-Agent Reasoning Orchestrator SDK, at the top of each page: the header slogan under the wordmark (desktop), the home-page hero kicker, the README title block, the social card and og:site_name.
  • After that, only the short name, Oracle Generative AI – Multi-Agent Locus SDK, or a generic "the SDK" / "the harness".
  • locus stays wherever it is code: the package, imports, the CLI, paths and URLs.

What changed

  • README, CONTRIBUTING, SECURITY, PROVENANCE: prose reworded.
  • docs/: about 110 pages reworded. Three headings changed, and the one same-page anchor that pointed at one of them was updated: "Try the SDK offline", "Pointing the SDK at the gateway", "When the SDK is a good fit".
  • mkdocs.yml site description; overrides/main.html tab title and Open Graph / Twitter tags; docs/stylesheets/locus.css header slogan (hidden below 56em, where it does not fit) and a .locus-hero__kicker rule; docs/img/og-card.svg and the re-rendered og-card.png.
  • pyproject.toml description (PyPI page on the next release) and the first line of the package docstring (rendered on the API reference).

Checks

  • No standalone "Locus" left in prose (code blocks, inline code and link targets excluded).
  • mkdocs build --strict passes locally.
  • Not in this PR: the repository's About description on GitHub (needs admin in the repository settings) and historical entries in CHANGELOG.md.

PR Legal (2026-11-05): "Locus" is not approved as a stand-alone product
name. The full name, Oracle Generative AI Multi-Agent Reasoning
Orchestrator SDK, now appears at the top of each page (header slogan,
home hero kicker, README title block, social card); after that the text
uses only the short name, Oracle Generative AI – Multi-Agent Locus SDK,
or a generic "the SDK". The logo and the lowercase wordmark stay.
`locus` stays in code, package, CLI and URLs.

- README, CONTRIBUTING, SECURITY, PROVENANCE: prose reworded
- docs: ~110 pages reworded; headings "Try the SDK offline", "Pointing
  the SDK at the gateway", "When the SDK is a good fit" (anchors updated)
- mkdocs.yml site_description; overrides/main.html tab title and
  Open Graph tags; stylesheet header slogan (hidden on mobile) and the
  new hero kicker; og-card.svg and og-card.png second line
- pyproject description and the package docstring first line

mkdocs build --strict passes. The mypy pre-commit hook was skipped
locally: it fails on pre-existing files this change does not touch
(temporalio stubs missing in the hook environment); CI runs it.

Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Nov 5, 2026
The README image pointed at locusagents.ai, so GitHub showed the old card
(and its image proxy caches it) until the site deploys. The raw file on
main updates with the merge and still resolves on PyPI.

Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
@fede-kamel
fede-kamel enabled auto-merge November 5, 2026 15:21
@fede-kamel
fede-kamel disabled auto-merge November 5, 2026 15:39
@fede-kamel
fede-kamel merged commit 43bd4c2 into main Nov 5, 2026
16 checks passed
@fede-kamel
fede-kamel deleted the docs/approved-product-name branch November 5, 2026 15:39
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